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PREFACE 



This manual provides an accurate description of control 
mode instructions, file structure, and job initialization 
for OS-3 Version 6. it does not include detailed des- 
criptions of particular software systems. A user, with 
this manual and the manuals about the particular software 
package he is using should, however, be able to use the 
system with very little additional assistance. 
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USER NOTES 



1. INTRODUCTION 



THIS MANUAL INCLUDES A LIST OF THE OS-3 CONTROL MODE 
COMMANDS. THIS LIST INCLUDES ALL SYSTEM COMMANDS ANO A 
BRIEF DESCRIPTION OF EACH, WI^H PARAMETERS, WHERE 
APPLICABLE. THIS IS BY NO MEANS MEANT TO BE A TOTAL 
SYSTEM REFERENCE MANUAL, FOR CERTAIN COMMANOS, SUCH AS 
LANGUAGES (FORTRAN, ALGOL, ETC), A REFERENCE MANUAL FOR 
THE PARTICULAR LANGUAGE OR MODULE IS ALSO NECESSARY. 



1,1. LOGGING IN 
i.i.i. FROM TELETYPE 



IF YOU ARE CALLING FROM OFF-CAMPUS THROUGH A TELEPHONE 

AND ACOUSTIC COUPLER ARRANGEMENT, DIAL THE TELEPHONE 

NUMBER CORRESPONDING TO THE BAUD RATE OF YOUR TERMINAL. 

FCR THE PHONE LINES AVAILABLE INTO OS-3, CALL THE 
COMPUTER CENTER I/O DESK <75<*-3 5Zh) . 

TO LOG IN FROM A TELETYPE MODEL 33 OR MODEL 35, SWITCH 
THE /LINE/LOCAL/ SWITCH TO THE /LINE/ POSITION. TYPE A 
CONTROL-A BY HOLDING THE KEY MARKED /CTRL/ ANO PRESSING 
THE /A/ KEY. IF OS-3 IS ACTIVE, THE TERMINAL SHOULD 
RESPOND WITH A CARRIAGE RETURN, A LINE FEED, AND A POUND 
SIGN. IF YOU RECEIVE NO RESPONSE* CHECK YOUR TELETYPE 
TO MAKE SURE IT IS ON-LINE. 

IF YOU RECEIVE A MESSAGE /NO PORT/, OS-3 COULD NOT FIND 
A FREE LOGICAL TERMINAL TO ASSIGN TO YOUR LINE. TRY 
AGAIN LATER. 

AFTER YOU RECEIVE THE POUND SIGN, YOU HOVE TWENTY 
SECONDS TO ENTER YOUR JOB NUMBER ANO VALIDITY CODE. 
CORRECT MISTAKES WITH THE BACKSLASH KEY OR THE CONTROL-H 
(BACKSPACE! KEY. WHEN YOU HAVE ENTERED YOUR ENTIRE JOB 
NUMBER ANO VALIDITY CODE, TYPE A CARRIAGE RETURN TO TELL 
THE COMPUTER YOU HAVE FINISHED. OS-3 WILL BLOT OUT THE 
AREA SO IT IS UNREADABLE ANO THEN, IF THE JOB NUMBEP WAS 
LEGAL, PRINT THE LOGON HEADER, CONSISTING OF THE DATE, 
TIME, YOUR TERMINAL NUMBERS, ANO THE AVAILABLE MONEY 
LEFT ON YOUR ACCOUNT. UNDER THIS LINE WILL BE PRINTEO 
ANY PUBLIC MESSAGES FOR THE DAY, FOLLOWEO 3Y ANY PRIVATE 
MESSAGES TO YOUR SPECIFIC ACCOUNT. WHEN ALL MESSAGES 
HAVE BEEN PRINTEO, THE TERMINAL WILL PESPONO WITH A 
CARRIAGE RETURN, LINE FEEO ANO A POUND SIGN TO SIGNIFY 
READINESS TO ACCEPT YOUR FIRST COMMAND. 



IF YOU RECEIVE A MESSAGE OF THE FORM* 

YOU ARE ALSO DETACHED ON TERMINAL NNN 

YOU MAY ENTER AN /ATTACH* ANO BE RECONNECTED TO YOUR 
PREVIOUS JOB AT THIS TIME, FOR THE ACTION OF THE ATTACH 
COMMAND AND ANY ERROR MESSAGES* SEE THE SECTION ON 
ATTACH, 

IF THE MESSAGE ^ILLEGAL J03/USER NUM3ER* IS PPINTEO, THE 
J08 NUM3ER ANQ/OR VALIDITY CODE ENTERED WERE INCORRECT. 
TRY AGAIN AND IF YOU STILL RECEIVE THE MESSAGE, TRY 
CONTACTING THE JOS NUMBER CLERK IF YOU FEEL THE NUM3ER 
SHOULD 9£ VALID. 

IF YOU RECEIVE THE MESSAGE /INSUFFICIENT TIME*, THE CPU 
TIME AVAILABLE ON THE ACCOUNT IS EXHAUSTED. 

1.1.2. FROM TV ICOC 211 DISPLAY DEVICES) 



LOGGING IN FROM A TV, SOMETIMES REFERED TO AS A CRT, IS 
A BIT DIFFERENT. TV*S HAVE NO CONTROL KEY, AND DO NOT 
COMMUNICATE IN THE /ASCII* CODE SET USED BY TELETYPES. 

TC ENTER YOUR JOB NUMBER AND VALIDITY CODE TO A TV, 
FIRST CLEAR THE SCREEN. THIS IS DONE 3Y PRESSING THE 
SLUE /CLEAR* BUTTON FOUNO ON THE UPPER LEFT-HAND PORTION 
OF THE KEY30AR0. WITH THE SCREEN CLEAR ANO THE CURSOR 
IN THE UF^ER LEFT-HAND PORTION OF THE SCREEN, ENTER A / 
CHARACTER (SHIFT-7). THIS IS THE SUBSTITUTE FOR THE 
CCNTROL-A KEY FOUNO ON THE TELETYPE. ANY TIME THIS 
CHARACTER IS FOUND IN THE EXTREME UPPER LEFT-HAND 
CHARACTER POSITION OF THE SCREEN, IT CAUSES CONTROL MODE 
(THE CONTROL STATEMENT PROCESSOR) TO READ THE SCREEN 
WHEN THE NEXT /SEND* IS PRESSED. THIS WILL CAUSE THE 
CURRENTLY RUNNING PROGRAM TO STOP EXECUTION RETURN TO 
THE CONTROL MODE PROGRAM TO READ THE DATA ON THE SCREEN. 

AFTER TYPING THE * CHARACTER, ENTER YCUR JOS NUMBER ANO 
VALIDITY CODE ON THE SAME LINE. YOU MAY CORRECT ANY 
TYPING MISTAKES 3Y USING THE FOUR KEYS IN THE LOWER 
LEFT-HAND PORTION OF THE KEYBOARD. THE *RES£T* KEY WILL 
RESET THE CURSOR TO THE FIRST CHARACTER POSITION ON THE 
SCREEN CSAME AS A /CLEAR* BUT THE CURRENT INFORMATION IS 
STILL DISPLAYEO ON THE SCREEN). THE *LINE-SKIP* WILL 
CAUSE THE CURSOR TO MOVE DOWN ONE LINE AND BEGIN ON THE 
FIRST CHARACTER OF THAT LINE. THE *8KS0* KEY WILL MOVE 
THE CURSCR BACK ONE CHARACTER SO IT IS UNDER THE 
PREVIOUS CHARACTER. TYPING A CHARACTER AT THIS POINT 
WILL REPLACE THE CHARACTER ABOVE THE CURSOR AND MOVE THE 
CURSOR RIGHT ONE POSITION. THE *SKIP* KEY WILL MOVE THE 
CURSOR TC THE RIGHT ONE CHARACTER POSITION WITHOUT 
CHANGING THAT CHARACTER. 



AFTER YOU HAVE ENTERED THE <*), YOUR CORRECT JOS NUMBER, 
ANO VALIOITV CODE ON THE SCREEN, PRESS THE *SEND* 
BUTTON. THIS IS THE BLUE BUTTON CN THE UPPER RIGHT-HAND 
PORTION OF* THE KEYBOARD. THIS OIRECTS ^HE COMPUTER TO 
READ THE INFORMATION YOU HAVE DISPLAYED ON THE SCREEN, 
UP TO AND INCLUDING THE SEND MARK (THE TRIANGLE 
DISPLAYED AFTER PRESSING THE *SENQ* BUTTON). 

IF THE JOB NUMBER AND VALIDITY COOF ARE VALIO, THE 
SCREEN WILL BE CLEAREO ANO A OISFLAY CONTAINING THE 
DATE, TIME, YOUR TERMINAL NUMBERS, ANO THE MONEY 
AVAILABLE ON YOUR ACCOUNT WILL BE DISPLAYED. ON THE 
NEXT LINE ANY PUBLIC MESSAGES AND/OR PRIVATE MESSAGES 
WILL 3£ OISPLAYED. WHEN THIS DISPLAY APPEARS, YOU MAY 
BEGIN ENTERING CONTROL STATEMENTS. 

IF THE MESSAGE ^ILLEGAL JOB/USER NUMBER* APPEARS, THE 
JCB NUMBER AND/OR VALIDITY CODE ENTERED WERE INCORRECT. 
TRY AGAIN AND IF YOU STILL RECEIVE THE MESSAGE, TRY 
CONTACTING THE JOB NUMBER CLERK IF YOU FEEL THE NUMBER 
SHOULD BE VALID. 

IF YOU RECEIVE THE MESSAGE * INSUFFICIENT TIME*, THE CPU 
TIME AVAILABLE ON THE ACCOUNT IS EXHAUSTED. 



l.i«3. FROM BATCH (CARD READER, RJE, OP REMOTE BATCH) 



A BATCH JOB IS COMPOSED OF A SET OF CARDS, THE FIRST OF 
WHICH IS A *JOB* CARD. THIS CARD CONTAINS THE SYMBOL 
*CJOB* IN COLUMNS ONE TO FOUR AND A COMMA IN COLUMN 
FIVE. AFTER THIS SYMBOL MAY BE AN OPTIONAL QUEUE FOR 
THE JOB*S DESTINATION. THESE QUEUES DETERMINE THE TIME 
AND RESOURCES THE JOB WILL NEED FOR EXECUTION. FOR MORE 
INFORMATION ABOUT QUEUE TYPES REFERE TO JOB UNDER 
CONTROL STATEMENTS. 

FOLLOWING THE JOB CARD ARE ONE OR MORE CONTROL STATEMENT 
CARDS WITH POSSIBLE INTERMIXED DATA CARDS. THE 
FOLLOWING IS AN EXAMPLE OF A JOB TO COMPILE AND RUN A 
SMALL FORTRAN PROGRAMt 



[JOB 


,FAST, 730123, FROG, ROBERT SCHWARTZ 


CTIHE=5 


[FORTRAN, L,R 




PROGRAM SHALL 


C 




C A 


SMALL PROGRAM TO PRINT THE SQUARE ROOTS 


C FROM THE DATA CARDS FOLLOWING THE PROGRAM. 


10 


REAQ(6Q,10O>X 


c 




C IF 
C 


END OF FILE, QUIT 


IFJEOM&OHGALL EXIT 




SR=SQRT(X> 




WRITE {61, 100)X,SR 




GOTO 10 


100 


F0RMAT(F2.D> 


101 


F0RMAT(X,F2.G,X,F6.<*» 




END 


cc 




10 




13 




12 




5 




Zh 




it 




CLOGOFF 



THE #FAST* ON THE JOB CARD IS USEH TO TELL OS-3 THE JOB 
WILL REQUIRE LITTLE CPU TIME AND SCRATCH FILE SPACE. 
THIS WILL SPEED THE J08*S PROCESSING ANO P0SSI3LY ALLOW 
IT TO PROCEED AHEAD OF LARGER JOBS CURRENTLY EXECUTING 
IN THE SYSTEM. 

FOR A DETAILED LIST OF THE POSSIBLE QUEUES A JOB MAY BE 
DIRECTEO TO, SEE THE CONTROL STATEMENT, *J08*. 

THE tit CHARACTER REPRESENTS THE 7-8 MULTIPUNCH NEEDED 
TO IDENTIFY THE CARD AS A CONTROL STATEMENT, THE CARD 
CONTAINING A ttit IS AN END-OF-FILE fEOFI CARO. 

TERMINATING THE DECK IS A *CLOGOFF*. THIS CARD 

FUNCTIONS THE SAME AS THE *LOGOFF* COMMAND USED FROM 
REMOTE TERMINALS. IT SIGNALS TO OS-3 THAT THERE ARE NO 
MORE CAROS TO BE READ AFTER THAT POINT. THIS INSURES 
THAT IF THE NEXT USER SUBMITTING A JOB FROM BATCH LEAVE 
HIS *(JOB* CARD OFF, YOU WILL NOT 3E CHARGED FOR 
PROCESSING HIS CAROS. <OS-3 WOULD THINK THAT SINCE NO 
*[J08* CARD WAS FOUND, THE NEXT USERS DECK MUST BE PART 
OF YOUR OECK.) 



2. CONTROL STATEMENTS 



THE FOLLOWING ARE CONTROL STATEMENTS 
OS-3, LISTED IN ALPHABETICAL ORDER. 



AVAILABLE UNOER 



2.1. 



ALGOL 



THIS COMMANO 
AVAILABLE* 



LOADS THE ALGOL-60 COMPILER. PARAMETERS 



A=<LUN> 

I = <LUN/NAP£> 

L = <LUN> 

P=<LUN> 

R 

X = <LUN> 



ASSEMBLY LISTING OUTPUT. 
SOURCE INPUT SPECIFIER. 
SOURCE LISTING OUTPUT UNIT. 
BINARY OECK PUNCH OUTPUT. 
LOAO AND RUN PROGRAM AFTER 
NO SEVERE ERRORS. 
BINARY OECK OUTPUT UNIT. 



COMPILATION IF 



NCTE* THE USE OF THE tRt PARAMETER IS DISCOURAGED SINCE 
THIS RESULTS IN A ^SEGMENTED* RUN OF THE PROGRAM 
WHICH SIMULATES THE USE OF A SMALL COMPUTER 
THROUGH THE USE OF MANY OVERLAYS AND SEGMENTS. 



2.2. 



ASSEM 



THIS COMMAND 
AVAILABLE: 



CALLS THE OS-3 ASSEMBLER. 



PARAMETERS 



D=<LUN/NAME> 
I = <LUN/NAME> 
L = <LUN/NAME> 
P=<LUN/NAME> 
R=<LUN/NAME> 

S = <LUN/NAME> 
X=<LUN/NA*E> 



DIAGNOSTIC OUTPUT FILE. 

SOURCE INPUT SPECIFIER. 

SOURCE LISTING OUTPUT UNIT. 

BINARY DECK PUNCH OUTPUT. 

GENERATES A CROSS REFERENCE OF SYMBOLS USEO 

IN PROGRAM. 

SYMBOL OUTPUT FROM ASSEMBLY. 

BINARY OUTPUT FILE. 



DEFAULT VALUE IF <LUN/NAME> NOT SPECIFIED? 



STANDARD 
STANOARD 
STANOARO 
STANOARO 
L UNIT OR 



OUTPUT UNIT <61J 
INPUT UNIT (60) 
OUTPUT UNIT (611 
PUNCH (621 
IF NO L THEN LUN 



61 



X UNIT OR IF X NOT USED THEN P UNIT 
STANOARD BINARY OUTPUT (56) 

-(EQUIPPEO IF NOT ALREADY DEFINED)- 



2.3* ATTACH 



THIS COMHANO WILL RE-CONNECT A USER TO A TERMINAL WHICH 
HAS BEEN /DETACHED*. THERE ARE THREE WAYS FOR A 

TERMINAL TO BE *OETACHEO*. 

1) THE USER TYPES *OETACH* WHILE IN CONTROL MODE. 

2) THE USER*S TELEPHONE 3EC0HES HUNG UP WITHOUT THE 
USER LOGGING OFF. 

3) THE USER*S TELETYPE SIGNAL PLUG IS DISCONNECTED 
FOR MORE THAN THIRTY SECONDS. (PRESSING THE 
*9REAK* KEY FOR MORE THAN THIRTY SECONDS WILL 
DETACH A TERMINAL.* 



TO PERFORM THE ATTACH COMMAND, TYPES 

ATTACH, <LOGICAL TERMINAL NUM3ER> 

-OR- 
ATTACH 

IF THE ATTACH IS SUCCESSFUL* A MESSAGE* ATTACH COHPLETE 
WILL 3E PRINTED AND YOU MAY THEN CONTINUE FROM WHERE YOU 
WERE INTERRUPTED. TO CONTINUE AN INTERRUPTED PROGRAM, 
USE THE *GO* OR *MI* COMMAND WHERE APPROPRIATE. 

THE SECOND FORM REQUESTS THE SYSTEM TO FIND THE HIGHEST 
TERMINAL NUMBERED JOB WHICH IS DETACHED UNDER YOUR J03 
NUMBER AND VALIDITY CODE. IF NONE ARE FOUNO, THE 
MESSAGE* 

ILLEGAL TERMINAL 

IS PRINTED ANO NO CHANGE OF STATUS HAS OCCURRED. 

THERE ARE TWO POSSIBLE ERROR MESSAGESt 

i) LEGAL FROM TTY ONLY 

THE USER MUST 3E AT A TELETYPE C0MPATA9LE 
DEVICE TO DO AN ATTACH. 

2) ILLEGAL TERMINAL 

THE LOGICAL TERMINAL SPECIFIED BY THE ATTACH 
COMMAND WAS EITHER 

A) NON-EXISTENT. 

85 NOT ONE GENERATED BY THE USER UOB/USER 

NUM3EP DIO NOT MATCH. ) 
C) NOT DETACHED, 



2.<f. 9ASIC 



THIS COMMAND CAUSES 3S-3 TO LOAO THE BASIC INTERACTIVE 
COMPILER, FOR MORE INFORMATION ABOUT BASIC, SEE THE 
COMPUTER CENTER MANUAL CCM-71-Q3. 



2.*?. BKSP 



THIS COMMAND CAUSES EACH OF THE LOGICAL UNITS SPECIFIED 
IN THE PARAMETER LIST TO BE BACKSPACED ONE PHYSICAL 
RECORD, IF THE LUN IS NOT A FILE OR A MAGNETIC TAPE OR 

THE FILE IS IN DESTRUCTIVE READ MODE, THE COMMAND WILL 
RESULT IN AN ERROR MESSAGE! 

ILLEGAL FUNCTION LUN NN. 
FORMATt 

BKSP, LUN, LUN,. ..,LUN 
8KSP,LUN<NUM3£R OF TIMES) ,.,. ,ETC. 

THE ABOVE FORMS MAY BE COMBINED. EXA*PLEt 

BKSP, i0,i2,13(<*5*,i(2t,3 



2,6. BREAK 



THIS CONTROL MODE COMMAND WILL CAUSE A SIMULATEO 
BREAKPOINT TO RADAR, TtiE ON-LINE DEBUGGING AID. ALL 

REGISTERS ARE RETAINED WHEN RADAR TAKES CONTROL, AND THE 
USER CAN THEN SINGLE-STEP, LOOK AT, OR MOOIFY HIS 
PROGRAM, OR OUMP CERTAIN AREAS Or HIS CORE MEMORY, 
REGISTER FILES OR REGISTERS, 

PLEASE 00 NOT CONFUSE THIS COMMAND WITH THE *3REAK* KEY 
ON THE TELETYPE KEY80AR0. 



2.7. CC 



THE CC COMMAND IS USED TO PROVIDE A COMMENTING FEATURE 
FOR BATCH CONTROL CARD DECKS. IN ADDITION, IT PROVIDES 
A LABEL FOR TRANSFER FROM GOTO AND IF STATEMENTS. 
EXCEPT FOR THESE TWO FUNCTIONS, IT IS BASICALLY A 
OC-NOTHING COMMAND, AS IT HAS NO EFFECT ON THE EXECUTION 
OF A JOB. 

WHEN USEO IN BATCH JOBS, THE CC STATEMENT IS LISTED ON 
THE STANCARD OUTPUT UNIT, PROVIDING DOCUMENTATION OR 
COMMENTS FOR T HE JOB. 

WHEN USEO IN CONJUNCTION WITH THE IF AND GOTO 
STATEMENTS, IT HAS A MORE IMPORTANT FUNCTION. THE FIRST 



ALPHANUMERIC STRING ENCOUNTERED, BEYOND THE *CC* AND 
DELIMITER, IS USED AS A LABEL FOR TRANSFER FROM IF AND 
GCTO STATEMENTS. FOR FURTHER OE T AILS SEE THE SECTIONS 
ON IF ANO GOTO STATEMENTS. 

THIS COMNANO IS LEGAL FROM TTY, TV, BATCH, TASK, ANO DO 
UNITS. 

EXAMPLESI 

CC THIS IS A COMMENT AND DOES NOTHING 

CC ZAP <ZAP MAY BE A LA8EL FOR IF AND GOTO STATEMENTS! 



2.8. CLEAR 



THIS COMMAND WILL CLEAR THE BINARY RECORD AND FILE MARK 
PROCESSEO BITS IN THE SPECIFIED FILE OR FILES STATUS, 

EXAMPLESI CLEAR,! 

CLEAR, 1,2, 10, 21 



2.9, COBOL 



THIS COMMAND LOAOS THE COC COBOL COMPILER. FOR 

INFORMATION ABOUT COBOL, ANO THIS VERSION OF THE 

COMPILER (2.0), SEE THE CDC LOWER 3900 COBOL REFERENCE 
MANUAL. 

PARAMETERS AVAILABLE! 

I - SPECIFIES THE INPUT UNIT/NAME WHICH CONTAINS THE 
PROGRAM TO BE COMPILED. 

L - SPECIFIES THE OUTPUT UNIT ON WHICH THE LISTING 
ANO DIAGNOSTICS ARE TO BE PLACED. THIS CAN ONLY 
8E A LUN, IF L IS USEO BUT NO LUN IS PRESENT, 
THE LISTING IS PLACED ON LUN 61. 

M - THIS CAUSES THE COMPILER TO PRODUCE A MEMORY MAP 
OF THE PROGRAMS DATA DIVISION STORAGE IF NO 
SEVERE DIAGNOSTICS WERE DETECTED IN COMPILATION. 
THE MAP IS WRITTEN ON THE L UNIT IF A LISTING 
WAS REQUESTED, OR ON LUN 61 IF NOT. 

- THIS CAUSES THE COMPILER TO PRODUCE A LISTING OF 
THE 08JECT CODE PRODUCED IF NO SEVERE 
DIAGNOSTICS WERE DETECTED DURING COMPILATION. 
THE OBJECT LISTING IS WRITTEN ONTO THE L UNIT IF 
IT WAS SPECIFIED OR ONTO LUN 61 IF NOT. 

P - THIS REQUESTS THE COMPILER TO PUNCH A BINARY 
OBJECT DECK ONTO THE SPECIFIED UNIT. IF NO UNIT 
IS SPECIFIED, LUN 62 IS ASSUMED. 



X - THIS CAUSES THE COMPILER TO PRODUCE AN OBJECT 

DECK ONTO THE SPECIFIED UNIT, IF NO LUN IS 

SPECIFIED, LUN 56 IS ASSUMED. IF THE LUN HAS 
NOT BEEN DEFINED IT*S EQUIPPED TO A FILE. 

EXAMPLE CALLSt 

C090L,I=PR0GRAM2,X,L 
COBOL, L f M,P 
C080L,L=10,X,0 



2.10. COMPASS 

COMMAND TO LOAD THE CDC COMPASS ASSEMBLER. THE 
PARAMETERS FOR *CONPASS* ARE THE SAME AS THOSE FOR 
*ASS£M* WITH THE ADOITION OF THE FOLLOWING t 

M - *MACRO* LIBRARY INPUT UNIT. 

ANY *LIBM* (LIBRARY MACRO) REFERENCES WILL 
ATTEMPT TO RETRIEVE THE NEEDED KACROS FROM THIS 
UNIT. IT MAY ONLY BE A LUN. 



2.11. COPY 

CALLS THE OS-3 GENERAL PURPOSE COPY UTILITY, AVAILABLE 
PARAMETERS! 

C - NUMBER OF RECORDS TO COPY FROM INPUT UNIT TO OUTPUT 
UNIT. 

F - NUMBER OF FILES TO COPY. 

THIS PARAMETER HAS TWO FORMS. THE FIRST IS F=N. 
USING THIS FORM WILL TELL COPY TO TRANSFER 
RECORDS FROM THE INPUT UNIT TO THE OUTPUT UNIT 
UNTIL N FILE MARKS HAVE BEEN COPIED. SPECIFYING 
F=0 WILL TELL COPY TO TRANSFER ALL RECORDS 
(UNTIL END OF DATA IS ENCOUNTERED). 

THE SECOND FORM IS F(N). THIS INSTRUCTS COPY TO 
TRANSFER RECORDS FROM THE INPUT UNIT TO THE 
OLTPUT UNIT UNTIL N CONSECUTIVE FILE MARKS HAVE 
BEEN COPIED. SPECIFYING F<G) WILL HAVE THE SAME 
EFFECT AS F=0. 

THE DEFAULT FOR THE F PARAMETER IS F = l FOR 
MAGNETIC TAPES AND TV*S AND F=C FOR ALL OTHERS. 

I - INPUT UNIT (LUN/NAME) FROM WHICH TO COPY, 
DEFAULTS TO LUN 100. 

N - LIST NUMBER OF RECORDS COPIED. 

COPY WILL PRINT A MESSAGE STATING HOW MANY 
RECORDS HAVE BEEN COPIED. THE MESSAGE WILL BE I 
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NNNNN RECOROS COPIED 

- OUTPUT UNIT FOR COPY (LUN/NAMEI. 

DEFAULTS TO LUN 61 FROM BATCH/TASK AND LUN 101 
FROM TV AND TTY. 

P - PARITY FOR OUTPUT FILE. 

(P=0 -> BCD, P=i -> 3INAPY) IF NOT SPECIFIED, 
RECORDS WRITTEN ONTO THE OUTPUT FILE WILL BE IN 
THE SAME HOOE AS THEY WERE READ FROM THE INPUT 
FILE. 

S - SHIFT PARAMETER. 

SPECIFIES NUMBER OF CHARACTER POSITIONS TO SHIFT 
A RECORD BEFORE OUTPUT TO THE *0* UNIT. IF S>0 
THEN SHIFT RIGHT. IF S<0 THEN SHIFT LEFT. IF 
S=0 THEN NO SHIFT. S DEFAULTS TO k IF OUTPUT 
UNIT IS AN LP OR TTY. 

T - TRUNCATION PARAMETER. 

SPECIFIES NUMBER OF WOROS TO TRUNCATE RECORD 
BEFORE WRITING IT ONTO THE tOt UNIT. NOTE* 
TRUNCATION IS CALCULATED BEFORE THE /SHIFT* IS 
APPLIED. DEFAULTS TO 250 WOROS ON TV (COC 211) 
AND TO ENTIRE INPUT RECORD SIZE ON ALL OTHER 
DEVICES. 

V - VARIABLE LENGTH RECORDS ON INPUT UNIT. 

RECORDS READ IN BCD MODE WILL HAVE TRAILING 
BLANKS REMOVED. RECORDS READ IN BINARY MODE 
WILL HAVE TRAILING WOROS OF ZEROS REMOVEO. 
DEFAULTS TO NO TRAILING WOROS REMOVED. 

AS WITH HOST OS-3 SYSTEMS PROGRAMS, SPECIFYING A LOGICAL 
UNIT IN THE RANGE OF 50 TO 59 FOR THE INPUT OR OUTPUT 
LUN WILL CAUSE THAT LUN TO BE REWOUND BEFORE USE. 
SPECIFYING A t/Rt PARAMETER ON THE LUN WILL H)RCE 
REWINDING BEFORE USE. IF THE PARAMETER t/Dt IS GIVEN IN 
PLACE OF THE */R*, COPY WILL REWIND AND SET DESTRUCTIVE 
READ ON THE LUN BEFORE USE. USERS ARE CAUTIONEO ABOUT 
USING THIS PARAMETER, AS IT IS NON-REVERSIBLE. IT 
SHOULO ONLY BE USED WHEN THE CONTENTS OF THE INPUT UNIT 
ARE NO LONGER NEEDED. 

EXAMPLE CALLS TO COPYI 

CCPY 

COPY, 1=1, 0=2 

COPY , 1= ZORCH, 0=Z AP, F=2 

COPY,I=5/R*0=3/R,N,C=iOO,T=15,S=-10 

COPY, 1=55, 0=2C 

CCP Y, 1=^/0, 0=5/R,F (21) 

ERROR MESSAGESl 
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INPUT UNIT IS ABNORMAL/UNAVAILABLE 

THIS INOICATES AN IRRECOVERA BLE PARITY ERPOR OCCURRED 
ON THE tit UNIT OR NAME. THE tit UNIT IS LEFT 
POSITIONEO JUST AFTER THE SAO RECORO <IF A LUN) AND NO 
MORE INFORMATION HAS 3EEN COPIED. FRO* BATCH, THE 
USER WILL BE ABORTED, 

INPUT RECORO TOO LARGE 

THE LAST RECORD READ FRCM THE tit UNIT WAS LARGER THAN 
COULD 8E CONTAINED IN MEMORY TO ALLOW COPY TO WRITE IT 
TO THE tOt UNIT, AS WITH THE ABOVE ERROR MESSAGE, THE 
tit UNIT WILL BE POSITIONED JUST AFTER THE BAD RECORO 
AND THAT RECORO WILL NOT HAVE BEEN COPIED. AS ABOVE, 
THE USER WILL BE ABORTED IF BATCH. <THE LARGEST 
RECORO THAT CAN BE COPIED IS ABOUT 62000 WORDS LONG.) 



2.12. COSY 



THIS LOADS THE CDC COMPRESSED 
AVAILABLE PARAMETERS! 



SYMBOLIC SOURCE EDITOR. 



I - SPECIFIES THE EDITING COMMAND INPUT UNIT. 
LUN IS SPECIFIED, LUN 60 IS USED. 



IF NO 



L - SPECIFIES THE LOG UNIT ONTO WHICH ALL EOITING 
INFORMATION AND ERROR MESSAGES ARE WRITTEN. IF 
NO LUN IS SPECIFIED, LUN 61 IS ASSUMED. 

Z - THE FREE-FORM FLAG PARAMETER. IF SPECIFIED, 
CAUSES COSY TO RELAX THE REQUIREMENT THAT ALL 
COMMANDS START IN COLUMN 10. IT IS ESPECIALLY 
USEFUL WHEN USING COSY FROM A REMOTE TERMINAL 
WHERE COUNTING BLANKS CAN BECOME VERY TIRESOME. 

/=<CHA3ACTER> 

SPECIFIES THE COSY COMMAND CARD CHARACTER IS TO 
BE CHANGED TO <CHARACT£R>. (CEFAULT TO t/t) 

EXAMPLE CALLS* 

COSY, LOG 

CCSY,I=10,L=20,Z 
COSY, INPUT=1, LOG, /=* 



FCR MORE INFORMATION ON COSY 
PUBLICATION CCM-7G-6. 



SEE T HE COMPUTER CENTER 
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2.13. DATE 



THIS COMMAND CALLS THE OATE UTILITY. THIS PROGRAM WILL 
PRINT THE CURRENT OATE AND TIME ONTO THE SPECIFIED LUN. 
IF NO LUN IS USEO, LUN 61 IS ASSUMED. EXAMPLE: 

DATE 

OCTOBER 8* 197^ 7lk5t3k AM 

DATE, 10 



2.1<*. OECKEDIT 

THIS GOfHANO CALLS THE OS-3 BINARY DECK EDITOR. 
DECKEOIT IS USED TO PREPARE AND UPDATE ^LIBRARY* FILES 
CONSISTING OF ONE OR MORE BINARY DECKS. THIS IS 
ESPECIALLY USEFUL FOR USERS WISHING TO CREATE A 
SUBROUTINE LIBRARY TO BE LOADED WITH VARIOUS MAIN 
PROGRAMS. 

PARAMETERS AVAILABLE ARES 

L - USED TO SPECIFY THE LI8RARY TO BE CREATED OR 
CHANGED. 

N - USED TO SPECIFY UNITS FOR NEW SUBPROGRAM 
INPUT. 

- USED TO SPECIFY WHICH SUBPROGRAMS ARE TC BE 
OELETEO. 

P - USFD TO SPECIFY PUNCH UNIT AND SUBPROGRAMS TO 
8E PUNCHED. 

1 - USED TO SPECIFY WHERE SUBPROGRAMS ARE TC 8E 
INSERTEO WITHIN THE LIBRARY. 

H - USED TO SPECIFY THAT SUBPROGRAMS ARE TO BE 
HELD. *HELO* SUBPROGRAMS REPLACE OLD COPIES OF 
THE SAME ROUTINES IN THE SAME POSITION WITHIN 
THE LIBRARY. 

$ - USED TO SPECIFY *ENO OF PARAMETERS*. 

FCR FURTHER INFORMATION ON OECKEDIT SEE THE COMPUTER 
CENTER PUBLICATION CCM-68-<^R. 
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2.15, OECKLIST 

THIS COMMAND CALLS THE OS-3 BINARY DECK LISTER. THE 
PURPOSE OF DECKLIST IS TO DISPLAY THE SUBPROGRAM NAMES 
(IOC), ENTRY POINT NAMES (E*>T), EXTERNAL SYMBOLS (XNL), 
TRANSFER SYMBOLS <TRA), AND HOLLERITH INFORMATION ON EXS 
CARDS, FOR ALL SUBPROGRAMS CONTAINED ON A 3INARY LIBRARY 
FILE, 

PARAMETERS AVAILABLE ARE: 

I - USEO TO SPECIFY INPUT UNIT. 

L - USED TO SPECIFY LISTING UNIT. 

FOR FURTHER INFORHATION ON OECKLIST SEE THE COMPUTER 
CENTER PUBLICATION CCM-59-3. 

2.16. OELAY 

ALLOWS THE USER TO SPECIFY THE DELAY TIME FOR HIS 
TERMINAL TO 00 A COMPLETE CARRIAGE RETURN. SOME TYPES 
OF TERMINALS ARE UNABLE TO COMPLETE A CARRIAGE RETURN IN 
ONE CHARACTER TIME, THE *DELAY* COMMAND CAN SET THIS 
OELAY TO CHARACTERS (THE DEFAULT) OR UP TO 7 
CHARACTERS OR ANY VALUE IN BETWEEN. 

FORMAT OF THE COMMANOt 

DELAYS 

WHERE N IS THE NUMBER OF CHARACTERS OELAY TO WAIT (FROM 
TO 7) . 

WHAT IS ACCOMPLISHED BY THE DELAY COMMANOt 

CONTROL MODE WILL PLACE INTO 3ITS 12-l<f OF THE USER*S 
REGISTER FILE 778 THE NUMBER GIVEN ON THE OELAY COMMAND. 
IT THEN EXAMINES THIS REGISTER FILE EACH TIME A CARRIAGE 
RETURN IS SENT TO THE TERMINAL TO OETERMINE THE NUMBER 
OF OELAY CHARACTERS TO SEND. ALSO, THE OS-7 WRITE 
INSTRUCTION WILL DO THE SAME AT THE ENO OF A LINE 
WRITTEN TO A TELETYPE. 

THE COOE SENT IS NOT A NULL CHARACTER, BUT A SPECIAL 
itCOB (NINE BIT COOE) WHICH OOES NOT ACTUALLY GO TO THE 
TERMINAL. IT IS TRAPPEO BY THE FRONT ENO PROCESSOR, AND 
CAUSES IT TO STOP SENOING TO THE TERMINAL FOR ONE 
CHARACTER TIME. ITS ONLY PURPOSE IS TO PROVIDE A OELAY. 
ANY USER MAY SEND THE ^008 CODE TO PPOVIDE THE SAME 
FUNCTION. 
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2.17. DELETE 



THE OELETE COMMAND IS USEO TO REMOVE THE NAME OF A SAVED 
FILE FROM THE FILE DIRECTORY. THE SAVED FILE MUST NOT 
BE PROTECTED. IN ORDER TO OELETE A PROTEC T EO FILE, 
PROTECTION MUST FIRST <3E REMOVED (SEE RFP) . BY FIRST 
EQUIPPING <LUN>=<FILENAME> A USER CAN OELETE THE 
<FILENAHE> AND STILL 3E ABLE TO REFERENCE THE 
INFORMATION ON THE <LUN> OR TO SAVE THE <LUN> UNDER 
ANOTHER <FILENAME>. 

EXAMPLES? 

DELETE, PROGRAM 

OELETE* ZIP, ZAP, 20NKER 

DELETE, IG^FREEP 

IN THE ABOVE EXAMPLE, THE LUN MUST 8E ALREADY 

EQUIPPED TO THE NAME *FRE£P*. 

ERROR MESSAGES! 

LUN NN UNDEFINED 

THE LUN SPECIFIED IS NOT EQUIPPEO. 

<NAM£> IS PROTECTEO 

THE NAME SPECIFIED IS PROTECTED AND A 
PROTECTEO FILE CANNOT BE DELETED. 

<NAME> IS NOT SAVED. 

AN ATTEHPT WAS MADE TO OELETE A HARDWARE 
OEVICE SUCH AS *LP*, 2PUN*, ETC. 

<NAM£> NAME-LUN INCONSISTENT 

THE LUN SPECIFIED WAS NOT THE ONE EQUIPPEO TO 
THE FILE <NAME>, 

<NAHE> INSUFFICIENT SCRATCH FILE SP^C^. 

IN ORDER TO DELETE A SAVEO FILE, IT MUST 3E 
MADE INTO A SCRATCH FILE TEMPORARILY. YOU 00 
NOT HAVE ENOUGH SCRATCH FILE SPACE LEFT TO 
ALLOW THIS OPERATION. IF YOU STILL WISH TO 
DELETE THE FILE AND 00 NOT WISH TO SAVE THE 
DATA ON A SCRATCH FILE, USE THE ^DESTROY* 
COMMAND. 
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£•18. DESTROY 



THE DESTROY COMMAND IS USED TO REMOVE FROM THE SYSTEM 
EACH OF THE FILES LISTED IN THE CALLING PARAMETERS. NO 
PRIVATE FILES MAY 3E PROTECTED FROM A DESTROY. 

EXAMPLES! 

QESTROY f ZIP 
DESTROY, FILEA, FILES 

THE COMMANO t DESTROY ,<FILENAME> IS EQUIVALENT TO t 

EQUIP, <LUN>=<FILENAME> 
RFP,<FILENAME> 
RELEASE, <LUN> 
DELETE, <FILENA*E> 
UNEQUIP,<LUN> 

NO ERROR MESSAGE IS ISSUED IF THE FILE DOES NOT EXIST. 



ERROR MESSAGES I 

<NAME> IS 3USY 

THE FILE NAME <NAME> IS CURRENTLY EQUIPPED 9Y 
SOME OTHER USER. 

<NAME> DOES NOT BELONG TO YOU 

THE FILE NAME <NAME> DOES NOT BELONG TO YOUR 
ACCOUNT AND IS PROTECTED. 

<NAME> INSUFFICIENT HARDWARE 

YOU TRIED TO OESTROY A PIECE OF HARDWARE WHICH 
CANNOT BE EQUIPFEO AT THIS TIME. 

<NAME> PARAMETER ERROR 

YOU TRIED TO DESTROY A HARDWARE DEVICE SUCH AS 
AN *MT*. 



2.19. DETACH 



THIS COMMAND WILL PLACE THE USER*S PROGRAM IN A 
SUSPENDED STATE FOR UP TO FIVE MINUTES. ITS USE IS TO 
ALLOW A USER TO MOVE FROM ONE TERMINAL TO ANOTHER SHOULO 
HIS TERMINAL BECOME 0ISA8LED OR THE LINE HE IS DIALED 
INTO BECOMES FAULTY. THE FOR* OF THE COMMAND IS* 

DETACH 

ISSUEO WHILE IN CONTROL MODE. IF THE USER DOES NOT 
*ATTACH* WITHIN FIVE MINUTES, HE IS AUTOMATICALLY LOGGED 
OFF WITH NO MESSAGE PRINTED US THERE IS NO TERMINAL TC 
PRINT THE MESSAGE ONI . 
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TC R£-COhN£CT TO THE JOB AT A LATER TIME, LOG IN TO THE 
SAME JOB/USER NUMBER FROM WHICH YOU /DETACHED* ANO ISSUE 
AN /ATTACH* COMMAND. <S£E ATTACH), 

THE ONLY ERROR MESSAGE ISSUED 3Y THIS COMMAND IS /LEGAL 
FROM TTY ONLY/ WHICH MEANS /DETACH/ IS ILLEGAL FROM 
NON-TTY DEVICES (COC 211 DISPLAYS* OR BATCH). 



2.20. DIR 



THE OIR COMMAND ENABLES A USER TO RECEIVE A LIST OF 
FILES CURRENTLY SAVED ON THE USER/S JOS NUMBER/ VAL IOITY 
CODE. SEVERAL PARAMETERS ARE ALLOWED ON THE OIR 
STATEMENT. THE FORM OF THE COMMAND IS AS FCLLOWSl 

DIR 

C ,0UTPUT=<LUN>1 

£,LONGl 

t ,FIL£NAM£=<FIL£NAME>] 

C»K£Y=£-]CHANG£] 

£,KEY=£-]R£F£RENCE] 

£,KEY=£-1SIZE3 

£,TYP£=£-1PR0TECTE01 

£ ,TYPE=t-!RAFl 

f ,TYPE=£-)8USY1 

£,TYPE=£-JABNORMAL) 

f ,CHANGE=<MMDDYY>£-<MMDDYY>/UPI] 

C ,R£FERENCE=<MMDDYY>£-<MMDOYY>/UPl 1 

£,SIZ£*<SIZE>[-<SIZE>/UP]] 

THE /OUTPUTS PARAMETER IS USED TO SPECIFY WHERE THE 
DIRECTORY IS TO BE WRITTEN. NORMALLY, THE DIRECTORY IS 
LISTED ON THE STANDARD OUTPUT UNIT- TV OR TTY, OR LINE 
PRINTER IF BATCH. WITH THE PARAMETER, OUTPUT MAY BE 
SENT TO ANY LUN THE USER DESIRES BY SPECIFYING 
0=<LUN>. <0=<FIL£NAME> IS NO LONGER VALID). IF THE 

INDICATED LUN IS NOT EQUIPPED, THE DIRECTORY PROGRAM 
WILL EQUIP A SCRATCH FILE TO USE FOR DIRECTORY OUTPUT. 

THE /LONG/ PARAMETER IS USED TO REQUEST A LONG FORM 
DIRECTORY. ORDINARILY, THE DIRECTORY LISTING IS JUST 
FILE NAMES, BUT WITH THE L PARAMETER, USERS MAY REQUEST 
OIRECTORY ENTRIES WHICH INCLUDE FILE SIZE ANO STATUS, 
LAST CHANGE DATE AND TIME, ANO LAST REFERENCE DATE AND 
TIME. 
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THE *KEY* PARAMETER IS USED TO SPECIFY SORT KEYS FOR 
ORDERING THE DIRECTORY, AND HAY APPEAR MORE THAN ONCE. 
NORMALLY, DIRECTORIES ARE PROVIOED IN ALPHABETIC ORDER, 
BUT A USER MAY ASK FOR THE DIRECTORY TO 3E LISTED IN 
EITHER FILE SIZE ORDER (K=S), CREATE/CHANGE DATE 
ORDER «=C), OR REFERENCE DATE ORDER (K=R). ANY 
COMBINATION OF SORT KEYS MAY BE SPECIFIED, HIGHEST TO 
LCWEST PRECEDENCE, EXCEPT THAT ALPHABETIC SORTING IS THE 
LOWEST PRECEDENCE AND IS NEVER SPECIFIED. A MINUS SIGN 
<-) PRECEDING A PARTICULAR SORT KEY INDICATES THAT THE 
KEY IS TO 3E USEO IN DESCENDING (RATHER THAN ASCENDING) 
ORDER. E.G. K=-C. 

THE /FILENAME* PARAMETER IS USEO TO REQUEST THE 
DIRECTORY ENTRY FOR JUST ONE PARTICULAR FILE NAME (E.G. 
F = SHS0*>07). WITH THE USE OF A *MASK* CHARACTER 
(QUESTION MARK ON TTY, *ANO* MARK ON TV (CDC 211), 0/7/8 
PUNCH ON CARDS), USERS MAY REQUEST VARIOUS SUBSETS OF 
THEIR DIRECTORIES BY INDICATING A /DONT-CARE/ CONDITION 
FOR PART OF THE NAME. THE MASK CHARACTER SERVES TO 
TERMINATE THE FILE NAME AND ALL POSITIONS OF THE NAME 
BEYOND THAT POINT ARE IGNORED. THUS F=*a WOULD LIST ALL 
PUBLIC FILES OWNEO, ANO F=A8Ca WOULD REQUEST INFORMATION 
FCR ALL FILES BEGINNING WITH /ABC/. 

THE /CHANGE/, PREFERENCE*, ANO /SIZE* PARAMETERS ARE 
BASICALLY THE SAME. THEY LIMIT THE ENTRIES TO 3E LISTED 
IN THE DIRECTORY BY ESTABLISHING A RANGE OF DESIRED 
VALUES FOR CREATE/CHANGE DATE, REFERENCE DATE, OR FILE 
SIZE, RESPECTIVELY. EITHER A SINGLE DATE OR SIZE MAY 3E 
PEQUESTEO (R=101576), OR A RANGE 0^ VALUES MAY BE GIVEN 
<S=5-50, C=G10175-123175> . THE WORD /UP/ MAY BE 
SU3STITUTED FOR THE UPPER BOUND ON A PARAMETER, 
INDICATING THAT ALL DATES OR SIZES ABOVE THE LOWER LIMIT 
ARE TO BE INCLUDED. BY MAKING THE LOWER BOUND ZERO, ALL 
SIZES OR DATES BELOW THE UPPER LIMIT WOULD BE LISTED. 
FCR EXAMPLE, S=10-UP WOULO INCLUDE ONLY THOSE FILES 
WHICH ARE AT LEAST 10 FILE 3L0CKS IN SIZE, ANO 
C=Q-12317€ WOULD INCLUDE ONLY THOSE FILES WHICH WERE 
CREATED OR CHANGED PRIOR TO 01/01/77. NO CHECKING IS 
DONE FOR LEGAL DATES, ANO THE USER ASSUMES ALL 
RESPONSIBILITY FOR ENTERING VALID OATES IN CORRECT 
/HMDOYY/ FORMAT. 

THE /TYPE/ PARAMETER IS USED TO REQUEST CERTAIN TYPES OF 
FILES TO BE LISTEO. FOUR TYPES ARE RECOGNIZEDl 
/A8N0RHAL/t /BUSY*, /PROTECTED*, AND *RANDOM* 
ACCESS(RAF). AS WITH THE *KEY* PARAMETER. THE *TYP£* 
PARAMETER MAY 3E REPEATED. ANY C0M3INATI0N OF THE FOUR 
LEGAL TYPES IS ACCEPTABLE. A MINUS SIGN PRECEDING A 
PARTICULAR TYPE INDICATES THAT THAT TYPE IS NOT TO BE 
USEO. THUS T=R,T=-3 WOULD LIST ONLY NON-BUSY RAFS. 
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PARAMETERS ARE NOT REQUIRED, ANO IF PRESENT, HAY APPEAR 
IN ANY ORDER OR COMBINATION. DEFAULT VALUES FOR CMITTEQ 
PARAMETERS ARE AS FOLLOWS I 

- STANDARD OUTPUT UNIT 

L - SHORT FORM LISTING 

K - ALPHABETIC SORTING 

F - ALL FILES 

T - ALL TYPES 

C - ALL CREATE/CHANGE DATES 

R - ALL LAST REFERENCE DATES 

S - ALL SIZES 

AS WITH HOST OS-3 SYSTEM SOFTWARE, ONLY THE FIRST LETTER 
OF A PARAMETER IS EXAHINEO IN ORDER TO DETERMINE THE 
PARAMETER TYPE. 

DIRECTORY OUTPUT INCLUDES THE DATE ANO TIME OF THE 
DIRECTORY PLUS ALL FILENAMES IN THE US£R*S DIRECTORY. 
LCNG FORM DIRECTORIES ALSO INCLUDE A HEADING DESCRIBING 
THE ADDITIONAL INFORMATION LISTEO. THIS INFORMATION 
CONSISTS OF THE FILE STATUSt * FOR PROTECTED, R FOR RAF, 
8 FOR BUSY, ANO A FOR ABNORMAL), THE FILE SIZE IN 
BLOCKS, THE LAST CHANGE DATE AND TIME IN MM/DD/YY HH 
FCRMAT, AND THE LAST REFERENCE DATE ANO TIME, ALSO IN 
MM/OD/YY HH FORMAT. NOTE THAT THE TIME IS LISTED ONLY 
TO THE LAST HOUR, 2^-HOUR FORMAT. 

ANY TIME A OIRECTORY IS PROVIDED WHICH DOES NOT CONTAIN 
ALL FILES OWNED, THE WORD *f SUBSET)* WILL APPEAR IN THE 
DIRECTORY TITLE TO INDICATE THE ABBREVIATED LIST. NO 
TITLE IS PRINTED WHEN REQUESTING ONLY ONE FILE ENTRY 
(F=<FILENAME>). 



2.21. DO 



THIS COMMAND CAUSES CONTROL MODE TO BEGIN EXECUTING 
CONTROL STATEMENTS FROM THE SPECIFIED FILENAME OR LUN. 
THE STATEMENTS DO MOT REQUIRE ANY SPECIAL CONTROL 
CHARACTER AT THE LEFT, ANO MAY BE CONTROL MCDE COMMANDS, 
LIBRARY CALLS, OR OVERLAY CALLS. IF PROCESSING IS 
INTERRUPTED BY A CONTROL-A FOR EXAMPLE, IT MAY BE 
RESUMED BY TYPING *GO* TO FINISH EXECUTION OF THE 
CURRENT CONTROL STATEMENT (SUCH AS *ASSEM*, 2F0RTPAN*, 
ETC.). WHEN EXECUTION IS COMPLETE, TYPE *DO* WITH NO 
PARAMETERS TO CONTINUE PROCESSING THE SUBSEQUENT 
STATEMENTS ON THE DO FILE. 

THE LUN OR NAME SPECIFIED IN THE PARAMETER LIST WILL 
ALWAYS BE REWOUND BEFORE CONTROL MODE PROCESSES THE 
FIRST CONTROL STATEMENT. EXAMPLES* 

DO, ZIP 

DO, 5 
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00 



ERROR MESSAGES! 

PARAMETER ERROR 

AN ILLEGAL FILE NAME OR BAD OR 
HISSING PARAMETER WAS GIVEN. 

DO UNIT ERROR 

AN ATTEMPT HAS BEEN MADE TO *D0* AN 
ILLEGAL FILE YPE (LP, ETC.). 

LUN XX UNDEFINED 

THE LUN SPECIFIEO 3Y XX IS NOT 
EQUIPPED, 

<NAMF> NOT FOUNO 

THE FILE NAME <NAME> DOES NOT EXIST. 

<NAME> IS SUSY 

THE FILE NAME <NAME> WAS NOT 
PROTECTED AND EQUIPPED BY ANOTHER 
USE 



2.22. DUMP 



THIS COMMAND WILL GENERATE AN OCTAL CORE MEMORY DUMP 
ONTO THE SPECIFIED LOGICAL UNIT. FORMAT! 

DUMPt, ABORTH,CLUNH,CLOW A0DR1»[HIGH AODRlll 

IF THE LOW AND HIGH ADDRESS ARE NOT SPECIFIED, THEN THE 
LCW ANO HIGH ADDRESS OF LOWER MEMORY ARE ASSUMED, 
RESPECTIVELY. IF THE LUN IS NOT SPECIFIED, LUN 61 IS 
ASSUMED. AFTER EXECUTION OF THE DUMP COMMAND, CONTROL 

IS RETURNEO TO OS-3 CONTROL MOOE. 

IF THE ABORT PARAMETER IS SPECIFIED, THE DUMP WILL BE 
GENERATED ONLY IF THE USER IS IN ABORT MODE. ONLY THE 
LETTER A IS REQUIPEO TO SPECIFY THE ABORT PARAMETER. 
EXAMPLE CALLS! 

DUMP,34,130GG,<*3233 

DUMP 

DUMP, ,10,1200 

DUMP, ABORT, i,123GC, 77777 

DUMP, A 

0UMP,A,13 
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2.23. EDIT 



THIS COMMANO GALLS THE OS-3 E 01 TOR.- THE EDITOR IS US£0 
TO PREPARE PROGRAMS OR OATA FILES FOR USE 3Y OTHER 
PROGRAMS OR PARTS OF THE OS-3 SYSTEM. FOR MORE 
INFORMATION ON THE E1ITCR. SEE THE COMPUTER CENTER 
MANUAL CCM-70-7R. EXAMPLE CALLI 

EDIT 
EOIT,I=<LUN>/<NAME> 

THE FIRST FORM CALLS THE EDITOR ANO ASSUMES INPUT FROM 
THE USER*S STANOARO INPUT DEVICE. THE SECOND FORM 

ALLOWS INPUT OF COMMANDS TO COME INITIALLY FROM THE 
SPECIFIED LUN OR NAME. EDIT WILL PERFORM A *00* ON THE 
SPECIFIEO INPUT UNIT UNTIL ALL RECORDS HAVE BEEN READ OR 
UNTIL AN ERROR OCCURS* AT WHICH TIME EOIT WILL REVERT TO 
INTERACTIVE MOOE, ACCEPTING COMMANDS FRCM t H £ US£R*S 
STANDARD INPUT DEVICE. 



2.2**. ENDSU8 



THIS COMMAND IS LEGAL ONLY IN SUBMIT MODE. THAT IS. 
WHILE PROCESSING A SUBMIT COMMAND. ANY EXTRA EN0SU3 
CARDS IN A DECK WILL RESULT IN THE ERROR! 

ILLEGAL CONTROL STATEMENT 

AND THE JOS WILL BE ABORTED. (SEE SUBMIT) 



2.25. EQUIP 



THIS COMMAND IS USED TO ASSOCIATE A LOGICAL UNIT NUM3ER 
WITH A NAMED FILE OR A PARTICULAR PIECE CF HARDWARE. 
THESE DEVICES ARE THEN REFERRED TO 3Y THE LUN. THE LUN 
MUST 3E AN INTEGER CONSTANT BETWEEN C AND 99, INCLUSIVE. 
WHEN A USER LOGS IN, THE FOLLOWING DEFAULT ASSOCIATIONS 
ARE MADE! 



LUN DEVICE 



60 


STANDARD 


61 


STANOARO 


10 


STANDARD 


101 


STANDARD 



INPUT (CAN 8E UNEQUIPPED) 
OUTPUT CCAN BE UNEQUIPPED) 
INPUT (PERMANENT) 
OUTPUT (PERMANENT) 
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MOST COMPILERS AND ASSEMBLERS USE LOGICAL UNITS BETWEEN 
5k AND 59. THUS* A USER SHOULD EXEPCISE CARE IN USING 
THESE UNITS, AS THEY ARE USEO AS SCRATCH UNITS BY SOME 
OTHER PROGRAMS. SOME SYSTE* SOFTWARE WILL UNEQUIP UNITS 
IN THE RANGE OF 5t TO 59. LUNS 100 AND 101 ARE 
PERMANENTLY ASSIGNED AS THE US£R*S STANDARD INPUT AND 
OUTPUT RESPECTIVELY. THEY MAY APPEAR ONLY ON THE RIGHT 
HAND SIDE OF THE EQUAL SIGN IN THE EQUIP CONTROL 
STATEMENT. FOR REMOTE USERS, STANDARD INPUT AND 
STANDARD OUTPUT BOTH REFER TO THE USER*S TERMINAL. 
BATCH USERS HAVE THE CARO READER AS INPUT AND THE LINE 
PRINTER AS OUTPUT. 

THE NAME TO THE RIGHT OF THE EOUAL SIGN MAY BE A 
PREVIOUSLY DEFINED LOGICAL UNIT NUMBER, A FILE NAME, OR 
ONE OF THE FOLLOWING! 

FILE - THE WORD FILE IS USED TO DEFINE A LUN AS 
A SEQUENTIAL DISK STORAGE AREA. THIS 
STORAGE AREA MAY BE SAVEO FOR FUTURE USE 
BY USING THE SAVE COMMAND. IF THE FILE 
IS NOT SAVED, IT WILL BE OESTROYEO WHEN 
LOGGING OFF OR WHEN IT IS UNEQUIPPED. 

L^ - THE WORD LP IS USED TO ASSOCIATE A LINE 
PRINTER TO THE LOGICAL UNIT. ANY 
INFORMATION WRITTEN ONTO THIS LUN WILL BE 
PRINTED ON A HIGH-SPEED PRINTER AT THE 
MILNE COMPUTER CENTER WHEN IT IS 
UNEQUIPPED OR WHEN LOGGING OFF. FOR 
INFORMATION ON DIRECTING THE INFORMATION 
TO OTHER LINE PRINTERS, SEE THE SEND 
COMMAND. 

MT <TAPE REEL NUM8ER> AT <DENSITY> <COMMENTS> 

THE SYMBOL *MT* FOLLOWED BY AN INTEGER IS 
INTERPRETED BY OS-3 AS A REQUEST TO MOUNT 
THE MAGNETIC TAPE SPECIFIED BY THE <TAPE 
REEL NUMBER>. THE DENSITY SPECIFIED MUST 
BE EITHER 203, 556* OR 800. THE TAPE 
REEL NUM8ER MUST BE NUMERIC AND BE LESS 
THAN 3398608. THE COMMENT FIELD IS 
PRINTEO ON THE OPERATOR CONSOLE AT THE 
COMPUTER CENTER, AND MUST CONTAIN THE 
INFORMATION AS TO THE RING STATUS (W OR 
Rl AND THE TAPE*S PASSWORD, ANY OTHER 
INFORMATION IS OPTIONAL AND IS UP TO THE 
USER. (SEE EXAMPLE IN EQUIP STATEMENTS 
BELOW) 
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NULL - THE WORD NULL REFERS TO A DEVICE WHICH 
DESTROYS ALL INFORMATION WRITTEN TO IT. 

PLOT - DEFINES A LUN TO 3E AN X/Y PLOTTER. 

PTP - DEFINES A LUN TO BE A PAPER TAPE PUNCH. 

PUN - DEFINES A LUN TO 3E A CARD PUNCH. 

RAF - DEFINES THE LUN TO BE A RANDOM ACCESS 
DISK STORAGE AREA. THIS STORAGE MAY BE 
SAVED FOR FUTURE USE WITH THE SAVE 
COMMAND. IF IT IS NOT SAVED, IT WILL BE 
OESTROYEO WHEN THE USER LOGS OFF CR WHEN 
THE LUN IS UNEQUIPPED. 

TASK - DEFINES A REMOTE BATCH FILE FROM WHICH 
CONTROL STATEMENTS WILL BE PROCESSED AS A 
BATCH JOB WHEN IT IS UNEQUIPPED. FOR 
INFORMATION ON THE USE OF TASKS, SEE THE 
SECTION ON SEND AND THE DESCRIPTION OF 
THE SUBMIT COMMAND. 

PUN, PLOT, PTP, ANO LP UNITS MUST BE LABELED TO PREVENT 
LOSS OF OUTPUT, (SEE LABEL) 

HSI(OEV) - 

DEFINES HIGH-SPEED INPUT DEVICE *OEV*. 
THESE ARE REAL-TIME SPOOLED DEVICES USED 
FOR DATA COLLECTION. CURRENTLY, 2DEV* 
MAY BE *PTR*, *PHAi*, OR *PHA2*. 

A PARTICULAR LUN MAY BE USED ON THE LEFT HAND SIDE OF 
THE EQUAL SIGN IN AN EQUIP ONLY ONCE, 

TC FURTHER AID IN THE ROUTING OF INFORMATION TO 
PARTICULAR DEVICES AND BATCH QUEUES, THE EQUIP COMMANO 
ALLOWS A DESTINATION SPECIFICATION ON EQUIPS TO NAMED 
DEVICES. THE DESTINATION IS SPECIFIED BY PLACING THE 
DESTINATION NAME IN PARENTHESES AFTER THE DEVICE TO BE 
EQUIPPED. SEE THE SEND COMMAND ON THE LEGAL 
DESTINATIONS FOR A PARTICULAR OEVICE. EXAMPLES* 

EQUIP, 1=FILE,2=FILE,3=FILE 

EQUIP, iO = 6Q,<*3=i0O 

EQUIP, V=NULL,2=PLOT 

EQUIP, 73=LP, 6=T ASK CNITE) 

EQUIP, 38=MT 2300G AT 556, W, PW = MUOD (SAUNDERS) 

EQUIP, 42=MT 90273 AT 800 ,R,PW=MYOATA 

EQUIP, 76=H3I(PHA2) 
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POSSIBLE ERROR MESSAGES I 

PARAMETER ERROR 

AN ILLEGAL OR MISSING PARAMETER 
ON ENTERED COMMAND 

<NAME> NOT FOUND 

THE FILE NAME <NAME> COULO MOT 
BE EQUIPPED. 

<NAM£> IS 3USY 

THE FILE NAME <NAME> IS NOT 
PROTECTED AND CURRENTLY 
EQUIPPED 9Y SOME OTHER USER. 

<NAM£> INSUFFICIENT HARDWARE 

THE HARDWARE DEVICE <NAME> IS 
UNAVAILABLE OR NOT AUTHORIZED 
TO 8E EQUIPPED AT THIS TIME 
(IE, MAG TAPES! . 

<NAME> DESTINATION UNKNOWN 
ON THE IMPLIED *SENO* 
OPERATION, THE DESTINATION 
GIVEN IN THE 

EQUIP, <LUN>=DEVICE( DESTINATION) 
IS UNKNOWN OR ILLEGAL FOR THIS 
DEVICE TYPE. (IE. *PR1* IS 

NO* LEGAL FOR A *PUN* DEVICE) 



2.26. FORMS 



THIS COMMAND WILL INFORM THE OPERATOR THAT SPECIAL FORMS 
ARE REQUIRED IN THE DEVICE ASSOCIATED KITH THE LUN, 
THIS COMMAND SHOULD ALSO BE USED WHEN LARGE VOLUMES OF 
MATERIAL ARE REQUIRED IN THE DEVICE. 

PLEASE NOTE THAT THE FORMS COMMAND PLACES A *FORMS 
RECORD* ON THE OUTPUT FILE AT THE CURRENT POSITION OF 
THE FILE. THE FORMS RECORD WILL ALERT THE OPERATOR AT 
THE SAME POINT THAT IT IS PLACED ON THE FILE. MORE THAN 
ONE FORMS RECORD MAY BE PLACED ON AN OUTPUT FILE. EACH 
FCRMS RECORD WILL ALERT THE OPERATOR AS IT COMES UP IN 
THE OUTPUT. 

FORMAT* 



?<♦ 



FORMS, <LUN>,<CONMENTS TO OP£RATOR> 

IF LUN IS 62 AMD UNIT 62 IS UNDEFINED 
EQUIPPED TO A *PUN*. 



IT WILL BE 



EXAMPLES! 



FORMS, 1G,TW0 PART 8 i/2 X 11 SADDLE PUNCH 
FORMS, 3, NEED AT LEAST 1/2 ROLL OF PAPER TA^E 
FORMS, 13, THREE UP GUM LABELS 



2.27. FORTRAN 



THIS CONTROL 
COMPILER. THE 



MODE COMMAND WILL CALL THE OS-3 FORTRAN 
AVAILABLE PARAMETERS ARE* 



A - 



SPECIFIES THE LUN ONTO WHICH AN ASSEMBLY 
LANGUAGE LISTING IS TO 3E WRITTEN. IF NO 
LUN IS PRESENT, THE L UNIT IS ASSUMED. 
IF NO L PARAMETER IS PRESENT, LUN 61 IS 
USED. 



C - 



THIS SPECIFIES THAT ASSEMBLY LANGUAGE 
STATEMENTS EQUIVALENT TO THE FORTRAN 
SOURCE PROGRAM ARE TO 8E WRITTEN ONTO THE 
SPECIFIED LUN. IF NO LUN IS SPECIFIED, 
LUN 62 IS ASSUMED. 



D - 



THIS LUN IS WHERE THE DIAGNOSTICS ARE 
WRITTEN. IF NO LUN IS SPECIFIED, THEY 
WILL GO TO THE L UNIT, IF NC L PARAMETER 
IS SPECIFIED, LUN 61 IS ASSUMED. 



E - 



NO LUN SPECIFIED. THIS INSTRUCTS FORTRAN 
TO GENERATE COMPREHENSIVE ERROR CHECKING 
INTO THE COMPILED PROGRAM. THIS EXTRA 
CHECKING PRINCIPALLY CHECKS FOR ARRAY 
BOUNDS ERRORS. THIS USUALLY ACCOUNTS FOR 
AN INCREASE OF ABOUT TEN PERCENT IN THE 
SIZE OF THE OBJECT PROGRAM PRODUCEO. 



H - 



I - 



THIS SPECIFIES THAT A COPY OF THE SOURCE 
OECK INPUT TO FORTRAN FOR COMPILATION IS 
TO BE WRITTEN ONTO THE SPECIFIED LUN. IF 
NO LUN IS SPECIFIEO, LUN 62 IS ASSUMED. 

THIS SPECIFIES THE LUN OR NAME FROM WHICH 
FORTRAN WILL REAO SOURCE STATEMENTS TO BE 
COMPILED. IF NO LUN IS SPECIFIED, LUN 60 
IS ASSUMED. FORTRAN WILL REWIND THE 
INPUT UNIT IF IN THE RANGE OF 50-59 OR IF 
FILE MARK STATUS IS PRESENT. INPUT UNITS 
IN THE RANGE OF 50 TO 59 ARE UNEQUIPPED 
AT ENO OF COMPILATION. 
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K - <NUMBER> ONLY. THIS TELLS FORTRAN WHICH 
CARD CODE TO ASSUME FOR THE INPUT DECK. 
IF K = 26 OR K IS NOT PRESENT, INFUT IS 
ASSUMEO TO 3E IBM 026 COOES, IF K=29, 
THEN INPUT IS ASSUMED TO BE EXTENDEO BCD 
CARO COOES. IF K=27, INPUT IS ASSUMEO TO 
CONTAIN BOTH 026 AND 029 CARC COOES. THE 
K OPTION SHOULD BE USED ONLY WITH SPECIAL 
CARO DECKS. 

L - ON THIS UNIT IS WRITTEN A SOURCE LISTING 
OF THE PROGRAM. IF NO LUN IS SPECIFIED, 
LUN 61 IS ASSUMEO. IF L IS NOT 
SPECIFIED, NO LISTING IS MADE. 

M - THIS SPECIFIES THAT A MAP OF SYMBOLS ANO 
THEIR RELATIVE POSITIONS WITHIN THE 
COMPILED PROGRAM, ANO ALL STATEMENT 
LABELS ANO THEIR RELATIVE FOSITIONS ARE 
TO 3E WRITTEN ONTO THE SPECIFIED UNIT. 
IF NO LUN IS SPECIFIED, LUN 61 IS 
ASSUMED. NO MAP IS MADE IF M IS NOT 
SPECIFIED. 

N - THIS PARAMETER SPECIFIES THE NUMBER OF 
LINES PER INCH TO BE WRITTEN ONTO THE 
LISTING UNIT. THIS PARAMETER MUST BE 
EQUAL TO 6 OR 8. ANY OTHER WILL RESULT 
IN AN ERROR MESSAGE. FORTRAN WILL WRITE 
THE NECESSARY CARRIAGE CONTROL ONTO THE 
LISTING UNIT TO SET THE PROPER SPACING 
DESIRED. IF THIS PARAMETER IS ABSENT, 
FORTRAN WILL USE THE SYSTEM DEFAULT 
SPACING. (CURRENTLY 8 LINES/INCH) 

P - ONTO THIS LUN WILL BE WRITTEN AN OBJECT 
DECK OF THE SOURCE PROGRAM COMPILED. IF 
NO LUN IS SPECIFIED, LUN 62 IS ASSUMED. 

R - THIS SPECIFIES THAT BINARY OBJECT OUTPUT 
SHOULO 3E SENT TO THE LUN SPECIFIED. IF 
NO LUN IS SPECIFIED, LUN 56 IS ASSUMEO. 
THIS PARAMETER DIFFERS FROM X IN THAT THE 
LUN IS RELEASEO BEFORE BEING WRITTEN ON, 
AND THAT THE OBJECT OUTPUT IS DESIGNED AS 
AN INPUT TO THE LOADER <SE£ I PARAMETER 
FOR THE LOAD COMMANO) , SINCE IT IS 
TERMINATEO BY A 3CD *RUN* RECORD. AFTER 
COMPILATION, IF NO SERIOUS ERRORS WERE 
OETECTEO, FORTRAN WILL CALL THE LOADER TO 
LOAD THE OBJECT DECK PRODUCED. 

S - THIS INSTRUCTS THE FORTRAN COMPILER TO 
WRITE SYMBOL OUTPUT (FOR RADAR, ETC.) 
ONTO THE SPECIFIED LUN. IF NO LUN IS 
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PRESENT, THE SYM30LS WILL 3E WRITTEN ONTO 
THE P DEVICE. IF P IS NOT SPECIFIED, THE 
X UNIT IS USED, IF THt X DEVICE IS NOT 
PRESENT, THE 9 UNIT IS ASSUMED, IF 

NEITHER P, X, NOR R IS PRESENT, AN ERROR 
HAS OCCURREO. 

X - THIS SPECIFIES THAT THE BINARY OBJECT 

OUTPUT OF THE COMPILATION IS TO BE 
WRITTEN ONTO THE SPECIFIED LUN. IF NO 

LUN IS PRESENT, LUN 56 IS ASSUMED, IF 
LUN 56 IS UNDEFINED, IT WILL 3E EQUIPPED 
TO A *FILE*. 

ALL LOGICAL UNITS EXPLICITLY SPECIFIED MUST HAVE BEEN 
PREVIOUSLY DEFINED 8Y THE USER, ANY OF THE PARAMETERS 
(A, C, 0, E, H, I, K, L, M, N, P, R, S, AND X) MAY BE 
OMITTED, AND THE DESIRED PARAMETERS MAY BE LISTED IN ANY 
OROER. 

EXAMPLES OF CALLS TO FORTRANl 

FORTRAN, I=TEST,S= 10, L=2G,P,A= 7 
-FORTRAN,L,R 
FORTRAN,L,R,E 
FORTRAN, 1=1 0/R,L=2G/R,P,S 
FORTRAN, R, I NPUT=PROGR AM, E 
F0RTRAN,L,R,K=2 9,P,A,0-1Q 

FOR MORE INFORMATION ON 0S-3 FORTRAN SEE THE 
COMPUTER CENTER PUBLICATIONS CCM-68-39P AND 
CCM-73-G**. 



2,28, FP 



THE COMMAND FP IS USED TO PROTECT A SPECIFIED FILE OR 
RAF. FILE PROTECTION MAKES THE FILE READ-ONLY AND THUS 
PREVENTS THE USER FROM ACCIDENTALLY MODIFYING THE FILE. 
A PROTECTED FILE OR RAF WHICH THE USER DOES NOT SAVE 
WILL BE DESTROYED WHEN THE USER LOGS OFF. A FILE WHICH 
HAS BEEN FILE PROTECTED MAY NOT BE DELETEO OR MOOIFIED 
UNTIL PROTECTION HAS BEEN REMOVED (SEE RFP COMMAND). 

EXAMPLES? 

FP, 10 

FP,1,2,3,*,5,ZIP,1C,ZAP 
FP, *BUGG£R 



POSSIBLE ERROR MESSAGES! 

<NAME> NOT FOUND 

THE FILE NAME <NAME> 3QES NOT EXIST 
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<NAME> IS BUSV 

THE FILE NAME <NAM£> IS CURRENTLY EQUIPPED BY 
SOME OTHER USER AND IS NOT ALREADY PROTECTED. 

<NAME> IS NOT A FILE OR RAF 

YOU CANNOT PROTECT A NON-SAVABLE HARDWARE TYP£ 
(E.G. TELETYPES, LINE PRINTERS, ETC.). 

<NAME> PARAMETER ERROR 

A MISSING OR ILLEGAL PARAMETER WAS SPECIFIED. 



2.29. FWSP 



THIS COMMAND IS SIMILAR TO THE BKSP COMMANO (SEE 8KSP) 
EXCEPT THAT THE FILE OR MAGNETIC TAPE IS SPACED FORWARO 
ONE PHYSICAL RECORD. 

EXAMPLES* 

FWSP,iO<10) ,2,3, f* 
FWSP,^G,*fi,**2,5 (100C1 



POSSIBLE ERROR MESSAGES* 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIEO COULD NOT BE FORWARD-SPACED. 
ONLY FILES, MT*S AND NULL*S CAN BE 
FORWARD-SPACED. 



2.33. GO 



THIS COMMAND WILL RESUME EXECUTION OF A USER PROGRAM 
WHICH HAS BEEN INTERRUPTED BY A *TIME CUT*, CONTROL-A OR 
SOME OTHER REASON. IF A PARAMETER LIST IS PRESENT IT 

WILL BE PLACED INTO THE US£R*S PARAMETER STRING BEFORE 
CONTINUING THE PROGRAM. 

EXAMPLES! 

GO 

GO,I = iQ,O = 2C,N = 10,T=if 
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2.31. GOTO 



THIS CONTROL STATEMENT IS VALID FROM 8A T CH, TASK* AND 00 

UNITS. IT IS USEO TO TRANSFER CONTROL IN A JOS STREAM 

FURTHER ALONG IN THE OECK. THE FORM CF THE COMMAND IS* 
(GOTO <LABEL> 

<LA3EL> IS ANY ALPHANUMERIC STRING, BEGINNING WITH A 
LETTERt ANO MUST 9E 1-6 CHARACTERS IN LENGTH. UPON 
ENCOUNTERING A GOTO STATEMENT, CONTROL MODE SKIPS ALL 
RECORDS IN THE OECK UNTIL A CCC IS FOUND WITH A MATCHING 
LABEL. <SE£ DESCRIPTION OF CC STATEMENT), 
CONTROL MOOE THEN RESUMES EXECUTION OF THE JC8 WITH THE 
NEXT STATEMENT IN THE OECK, 

IF NO CC STATEMENT IS FOUND WITH A LABEL MATCHING THAT 
OF THE GOTO, THE JOS WILL LOG OFF COR TERMINATE IF A 00 
FILE) WITHOUT EXECUTING ANY FURTHER CONTROL STATEMENTS, 

WHEN SKIPPING AHEAD UNDER CONTROL OF A GOTO, CONTROL 
MCOE WILL LIST ALL STATEMENTS NOT EXECUTED, PRECEDING 
EACH WITH »♦• NOTE ALSO THAT TRANSFER CAN OCCUR ONLY 
FORWARD WITHIN A OECK, NEVER 8ACKWAR0. 

EXAMPLES* 

GOTO NEXT 
G0T0,LIST3 



2.32. HI 



IN RESPONSE, OS-3 WILL PRINT OUT THE DATE, TIME OF DAY, 
THE USER*S J03 NUM£ER, TERMINAL NUM3ERCS), CURRENT 
TRAFFIC, TOTAL TRAFFIC FOR THE DAY, AND SAVED AND 
SCRATCH SLOCK USE ANO LIMITS, 



2.33. IF 



THIS STATEMENT ALLOWS USERS TO EXECUTE CONDITIONALLY 
CONTROL STATEMENTS WITHIN 9ATCH, TASK, OR 00 FILES. THE 
FCRM OF THE COMMANO IS t 

CIF <<EXPRESSION>) <LA3EL> 

THIS IS VERY SIMILAR TO A FORTRAN *IF* STATEMENT. 
<EXPRESSICN> IS A TRUE OR FALSE VALUE (NON-ZERO OR ZERO) 
BASED ON THE OPERATIONS ANO OPERANDS GIVEN IN THE 
STATEMENT. <LABEL> IS THE LA8EL ON A CCC STATEMENT (SEE 
CC COMMANO FOR MORE OETAIL) TO WHICH CONTROL IS TO BE 
TRANSFERRED IF THE RESULTING VALUE IS TRUE. TRANSFER 
MAY ONLY OCCUR FORWARD WITHIN A JOB. 

THE STATEMENT IS SET UP EXACTLY LIKE A FORTRAN IF 
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STATEMENT. OPERATORS ALLOWED ARE: ♦ - » / . EQ. .NE. 
• GE. .LT. ,GT. .LE. .IS. .AND. .OR, .NOT. 

OPERANDS HAY 8E NUMBERS IN THE RANGE 0-8388607. 

NEGATIVE NUMBERS ARE NOT ALLOWED NOR IS THE UNARY MINUS. 

OPERANDS MAY ALSO BE ANY OF THE FOLLOWING RECOGNIZED 
SYMBOLS! 

SUNOAY MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY 
SATURDAY fP LDPT EOD EOF SDR 3IN AU AE SAV BUSY PTP 
MSF TASK RAF TV NULL PLOT TTY RJE MT CR PUN LP FILE 
UNOEF TODAY TOO DATE SFLEFT MFLEFT TIMELEFT LOADDEL 
ABORTED CFBLKS MF8LKS SF3LKS TIME WCT UNITREC 

THE FOLLOWING FUNCTIONS ARE ALSO ALLOWEO* 
STATUS <<LUN/NAME>> SIZE (<LUN/NAME> ) 
RECOROSC<LUN/NAME>) TYPE l<LUN/NAME> ) 

EXPRESSIONS MAY BE BUILT AS IN FORTRAN WITH ANY NUMBER 
OF OPERATORS AND OPERANOS ANO PARENTHESES WHERE NEEDED 
PROVIDING PROPER FORTRAN SYNTAX IS OBSERVED. 

A FEW CLARIFICATIONS! 

*TOD* RETURNS TIME OF DAY IN Zk HOUR HHMM FORMAT. 

*OATE* RETURNS TOOAYS DATE IN YYMMOC FORMAT. 

*TODAY* RETURNS THE OAY OF THE WEEK AS A LOGICAL MASK 
WHICH CAN BE TESTED AGAINST THE SYMBOLS *MONDAY*, 
*TU£SOAY*, ETC. 

THE STATUS FUNCTION RETURNS A VALUE OF *BUSY* (FILE IS 
BUSY), *SAVEQ* !A PERMANENT NAME HAS BEEN ASSIGNED TO 
THE FILE), *AE* (AOORESS ERROR - RAF ONLY), *AU* 
(ABN0RMAL/UNAVAILA3LE - PARITY ERROR), *SIN* (LAST 
RECORD PROCESSED WAS IN BINARY MQOE) , *SOR* (FILE IS 
IN DESTRUCTIVE READ MOOE), *EOF* (LAST RECORD 
PROCESSED WAS AN END OF FILE), *LDPT* (FILE IS AT LOAD 
POINT - BEGINNING OF INFORMATION), OR *FF* (FILE IS 
PROTECTED), 

THE 2. IS.* OPERATOR WORKS LIKE A FORTRAN /AND* 
FUNCTION. THAT IS, THE RESULT OF *A.IS.8* IS THE 
LOGICAL ANO OF A ANO B. IT HAS THE SAME PRECEDENCE AS 
.EQ. ETC. ANO CAN BE USED TO TEST FOR A PARTICULAR 
CONOITION WITHIN A STATUS. PLEASE SEE EXAMPLES BELOW. 

THE *TYP£* FUNCTION RETURNS THE HARDWARF TYPE. EITHER 
*UNDEF* (UNOEFINED), #FILE#, *RAF*, *CR*, *PUN*, *LP*, 
*PLOT*, *TV*, *TTY*, *NULL*, *RJE*, tPTPt, OR *MT*. 

THE SYMBOL *UNITREC* (FOR UNIT RECORD DEVICE) IS 
OEFINED AS EITHER *PUN*, tlPt, tPlOTt, OR tPJPt. 
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IF THE VALUE OF THE EXPRESSION OF AN IF COMMAND IS TRUE, 
CONTROL IS TRANSFERRED AHEAD IN THE OECK TO THE FIRST CC 
STATEMENT ENCOUNTERED WITH THE SAME <LABEL> SPECIFIED IN 
THE IF STATEMENT. ALL COMMANDS NOT EXECUTED ARE LISTED, 
PRECEOED BY ♦*. IF THE RESULT IS FALSE, CONTROL MODE 
SIMPLY PROCEEDS TO THE NEXT STATEMENT AS IF THE IF 
STATEMENT WERE NOT EVEN THERE. 

EXAMPLES* 

IF < TO OAY. IS. MONDAY) ZIP 

IF (ST A TUS(*Z). IS. FP. AND.. NOT. ABORTED) JUMP14 

IF { TI ME. LT. 2 3. AND. MFL EFT. GE. 100) NEXT 

IF (OATE.GE. 761001. OR. TYPECiGi) .EQ.RJE)80M3 

IF! TODAY. IS. SATURDAY +SUNDAY) WEEKENO 

IF(REC0R0S(16) .LT. 2C00) MORE 

IF (SIZE (BIGFILE).GE. 70 0) QUIT 

IFCTIME*6+MF3LKS*3*SFBLKS/2.GE.900)ZONKER 

IF (TYPE (16) .IS.LP+PUN)DUMP3 

IFCLOAD0ELISTOP99 

IF{WCT.GE.60.OR.TIME.GE.20C) YELL 



2.34. J08 



THIS CONTROL STATEMENT IS VALID ONLY FROM 8ATGH OR TASK, 
AND SHOULD BE THE FIRST CARD IN A DECK. THE JOB CARD IS 
USED TO IDENTIFY A BATCH JOB TO OS-* SO THAT CHARGES MAY 
BE MADE AGAINST THE APPROPRIATE ACCOUNT. THE FORMAT OF 
A JOB CARD ISt 

[ JOS, t QUEUE, ]J08-NUM,VAL-C00E,£61=NAME .1COMMENTS 

THE tit AROUND THE *QUEUE* AND *6i=NAME.,.* ARE TO 

DENOTE OPTIONAL FIELDS. THE t[ JOB* DENOTES A 7-8 

MULTI-PUNCH IN COLUMN 1 FOLLOWED BY *JOB* IN COLUMNS 
2-4. FOR A *TASK* JOB, USE A tit, 

THE QUEUE PARAMETER MAY BE ONE OF THE FOLLOWING! 

FAST - QUEUE FOR JOBS REQUIRING LESS THAN 30 CPU 

SECONDS OR 100 SCRATCH FILE BLOCKS. THE 
ADVANTAGE OF THIS QUEUE IS THAT IT HAS A 
HIGHER PRIORITY FOR GETTING LOGGED IN 
THAN ANY OF THE OTHER QUEUES. ONCE 
LOGGED IN, HOWEVER, IT HAS THE SAME 
PRIORITY AS ANY OTHER JOB. DUE TO THE 

SMALL TIME AND FILE SPACE LIHITS, THOUGH, 
JOBS IN THIS QUEUE SELDOM EXECUTE MORE 
THAN A FEW MINUTES. 

LOW - QUEUE FOR JOBS WISHING TO EXECUTE DURING 

SECOND OR THIRD SHIFT. JOBS SPECIFYING 
THIS PARAMETER WILL NOT BEGIN EXECUTION 
UNTIL NON-PRIME TIME IS IN £FF£CT. 
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NITE - QUEUE FOR J03S WISHING TO EXECUTE DURING 
THIRO SHIFT, SPECIFYING THIS PARAMETER 
WILL CAUSE THE JOS TO EXECUTE ONLY OURING 
THE CHEAPEST RATES AVAILABLE. 

MT1 - QUEUE FOR JOBS REQUIRING i TAPE DRIVE 

MT2 - QUEUE FOR JOSS REQUIRING 2 T *PF DRIVES 

MT3 - QUEUE FOR JOBS REQUIRING 3 TAPf DPIVES 

MTtf - QUEUE FOR JOBS REQUIRING k TAPE DRIVES 

IF THE QUEUE FIELD IS HISSING OR DOES NOT CONTAIN ONE OF 
THE A30VE, THE JOB MAY HAVE ANY TIME OR SCRATCH LIMIT, 
BUT HAY NCT USE TAPES. 

FCR INFORMATION ON HOW TO USE THESE QUEUES FOR TASK 
JC3S, SEE SEND STATEMENT. 



2,35. LABEL 



LABEL IS A UTILITY PROGRAM USED TO LABEL SOME OUTPUT 
OEVICE TO ALLOW THE COMPUTER CENTER OPERATIONS STAFF TO 
DETERMINE THE OWNER OF THE OUTPUT. THE GENERAL FORMAT 
IS: 

LA3ELC ,<LUN>C= OR I <HW TY»E>11 t OR / <MESSAGE> 

IF THE CHARACTER FOLLOWING THE SPECIFIED LUN IS AN 
APOSTROPHE <*>, THE MESSAGE WILL BE WRITTEN ONTO THE LUN 
STARTING IN COLUMN ONE AS ONE BCD RECORD. IF THE 
CHARACTER IS A SLASH (/*, THE MESSAGE WILL BE WRITTEN IN 
A FORMAT TO MAKE IT MORE READABLE FOR THE TYPF OF DEVICE 
SPECIFIED BY THE LUN. FOR EXAMPLE, IF THE LUN IS AN LP, 
THE MESSAGE WILL BE WRITTEN IN LARGE LETTERS. IF THE 
LUN IS A PUN, A CARD WILL BE PUNCHED WITH THE FIRST 
SEVEN CHARACTERS OF THE MESSAGE IN BLOCK LETTERS. IF 
THE LUN IS A PLOTTER THE LA3EL WILL 8E PLOTTEO IN 
LETTERS ONE-HALF INCH HIGH. FOR THE PAPER TAPE PUNCH, 
LARGE CHARACTERS WILL BE BLOCK PUNCHED ONTO THE PTP. IF 
THE LUN IS NOT SPECIFIED, LUN 61 IS USED. 

IF THE CHARACTER FOLLOWING THE SPECIFIED LUN IS AN EQUAL 
SIGN t=> , LABEL WILL EQUIP THE LUN TO THE SPECIFIED 
HARDWARE TYPE. IF THE CHARACTER IS A COLON (H AND THE 
LUN IS NOT EQUIPPEO, LABEL WILL EQUIP THE LUN TO THE 
SPECIFIED HAROWARE TYPE. IF THE CHARACTER IS A COLON 
AND THE LUN IS EQUIPPEO TO A FILE, MT, NULL, OR THE SAME 
HAROWARE TYPE, LABEL WILL USE THE HAROWARE TYPE 
SPECIFIED TO LABEL THE LUN. LEGAL HARDWARE TY^ES AREt 
FILE, LP, PUN, PTP, ANO PLOT. 

IF LUN 62 IS SPECIFIED AND NOT EQUIPPED, LABEL WILL 
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EQUIP IT TO THE PUNCH. 

WHEN LABELING A PRINTER OR PUNCH* ADDITIONAL SLASHES 
BEYOND THE FIRST ONE MILL ADVANCE TO A NEW SET OF LINES 
ON THE PRINTER, OR A NEW CARD ON THE PUNCH. 

EXAMPLE! 

LABEL, 10*THIS IS A SINGLE LINE LABEL 
LABEL, 7/SAVE PLOT FOR HOLIES 
LA3EL/LACAZOWITCZE 
LABELED HARLAN ELLISON 
LABEL, 5=LP/NAME ANO DEPARTMENT 
(SANE AS1EQUIP 5=LP 

LABEL 5/NAHE ANO DEPARTMENT* 
LABEL, 9=PUN/INT£RP/67Q0OB /NAME 
LABEL, 1GIPLOT/NAME 

(EQUIP TO PLOT IF NOT EQUIPPED THEN PUT A 
PLOT LABEL ON 10 IF EQUIPPED TO FILE, MT 
NULL, OR PLOT J 



c . 3 o « L L 



ABBREVIATED COMMAND FOR LUNLIST. SEE LUNLIST FOR FULL 
DESCRIPTION. 



2.3?, LOAO 



THIS CONTROL MODE COMMAND CALLS THE OS-3 BINARY PROGRAM 
LCADER. BINARY INPUT IS PRODUCED BY COMPILERS AND 
ASSEMBLERS (FORTRAN, ASSEM, ALGOL, COBOL, ETC.). THE 
INFORMATION IS LOADEO FROM THE LUNS OR NAMES SPECIFIED 
AFTER THF LOAD COMMAND. A LUN FOLLOWED BY t/Rt WILL BE 
REWOUND BEFORE ANY INFORMATION IS READ FROM IT. 

THE LOADER INFORMATION (BINARY DECKS} WILL B£ LOADED IN 
THE ORDER SPECIFIED BY THE ORDER OF THE DECKS OR 
PARAMETERS. AFTER INFORMATION IS EXHAUSTED FROM ONE 
PARAMETER, THE NEXT UNIT WILL BE PROCESSED FOR LCADER 
INFORMATION. THE AVAILABLE PARAMETERS AREi 

I - SPECIFIES THE UNIT OR NAME FROM WHICH 
LOADER COMMAND INFOPMATION IS TO BE READ. 
IF A LUN IS NOT SPECIFIED, LUN ICQ IS 
ASSUMED. 

L - SPECIFIES A LIBRARY FROM WHICH EXTERNAL 
SUBPROGRAMS WILL Q^ LOADED IF NOT 
INCLUDEO IN THE BINARY DECKS LOAOEO. 

- SPECIFIES A LUN OR NAME ONTO WHICH AN 
OVERLAY OF THE CORE IMAGE WILL BE WRITTEN 
AFTE 3 ? LOADING HAS TERMINATED. THIS NAME 
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(OR NAME WHEN LUN IS *SAVED*) CAN THEN BE 
TYPED AS A CONTROL STATEMENT TO 9EGIN 
EXECUTION, 

THERE MAY 8E ONLY ONE I AND ONE PARAMETER. HOWEVER, 
THERE MAY 3£ ANY NUM3ER OF L PARAMETERS AND THESE WILL 
3E PROCESSED FROM RIGHT TO LEFT. 

LCADER COMMANDS (VALID ONLY ON COMMANO INPUT) J 

RUN - TERMINATE LOADING AND BEGIN EXECUTION OF 
THE PROGRAM IN CORE. THIS WILL CAUSE ALL 
EXTERNAL REFERENCES TO 8E RESOLVED, 
POSSIBLY CAUSING SOME SUBPROGRAMS TO BE 
LOADED FROM THE SPECIFIED LI3RARY UNITS* 
OR FROM *LI8 (THE MAIN FORTRAN LIBRARY) 
IF NONE WERE SPECIFIED. ERROR MESSAGES 
WILL 3E PRINTED FOR EACH UNRESOLVED 
EXTERNAL REFERENCE. EXCEPT THAT 
EXECUTION WILL NOT BEGIN. 

END - THE UNIT WILL BE WRITTEN (IF PRESENT) 
AND ALL EXTERNAL REFERENCES WILL 8£ 
RESOLVED IF POSSIBLE. DIAGNOSTICS WILL 
RESULT FOR ALL UNDEFINED SYMBOLS. 
CONTROL IS RETURNED TO CONTROL MODE WHEN 
THE LOAOING IS FINISHED. 

MAP - THE MAP STATEMENT CAUSES A MEMORY MAP TO 
BE PREPARED OF THE SUBPROGRAMS AND ENTRY 
POINT SYMBOLS AND THEIR ABSOLUTE MACHINE 
ADDRESSES. ON A TTY, THE FIRST MAP 
COMMAND WILL RESULT IN CNLY A LIST OF 
SUBPROGRAM NAMES. TYPING MAP A SECOND 
TIME WILL RESULT IN A COMPLETE MEMORY 
MAP. IF A LUN IS SPECIFIED, AS IN 
MAP=<LUN> THEN THE MAP WILL BE WRITTEN 
ONTO THIS LUN. ALL EXTERNAL REFERENCES 
ARE RESOLVED 8EF0RE THE MAP IS PRINTED 
AND THE OVERLAY IS WRITTEN, IF REQUESTED. 

RADAR - THIS COMMANO WILL CAUSE THE PROGRAM 
LOAOING PROCESS TO FINISH (AS IN RUN) 
THEN CONTROL IS TURNED OVER TO RAOAR, AND 
THE ENTRY POINTS AND SUBPROGRAM NAMES ANO 
THEIR ADDRESSES ARE PASSED TO RADAR TO 
ALLOW MORE EFFECTIVE DEBUGGING, (SEE 
RAOAR MANUAL) 

EXS - THIS COMMANO WILL ALLOW THE USER TO 
DEFINE EXTERNAL SYMBOLS. IT IS USED TO 
DEFINE A VALUE TO A SYMBOL WHICH IS NOT 
DECLARED AS AN ENTRY POINT IN ANY OF THE 
USER*S PROGRAMS, THIS COMMAND IS TREATED 
AS A BINARY RECORD ANO MAY OCCUR ON 
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COMMAND INPUT AS WELL AS WITHIN A BINARY 
DECK, (I.E. IT DOES NOT TERMINATE THE 

LOADING PROCESS.) 

EXAMPLES! 1» EXS, <S YM80L>=<VALU£> 
21 £XS,<SYM30L> =<VALUE> 
3) EXS,<SYM30Ll>=<SYMS0L2>*<VALUE> 
M EXS,<SYM80LA>=<SYMB0LB> 

IN EXAMPLE i, A SYM80L IS ASSIGNED AN OCTAL VALUE. IN 

NUMBER TWO, A SUBPROGRAM NAME IS ASSIGNED AN ABSOLUTE 
OCTAL LOCATION. IN NUMBER THREE, A SYMBOL IS GIVEN THE 
VALUE OF ANOTHER SYMBOL AOOEO TO A CONSTANT. IN NUMBER 
FOUR, A SYMBOL IS GIVEN THE SAME VALUE AS ANOTHER 
SYMBOL. 

TRA - THIS COMMAND IS USED TO SPECIFY A 

TRANSFER ADDRESS TO THE LOADER. 

NORMALLY, TRANSFER ADDRESSES ARE 

GENERATED AUTOMATICALLY BY COMPILERS AND 
ARE OF NO CONCERN TC THE AVERAGE USER. 
SOME USERS MAY, HOWEVER, DESIRE TO 

SPECIFY A PARTICULAR STARTING ADDRESS TO 
THE LOADER AND MAY 00 SO WITH THIS 
COMMAND. THIS COMMAND DOES NOT TERMINATE 
THE LOADING PROCESS. 

LIB - THIS COMMAND IS USED TO SPECIFY 

ADDITIONAL LOADER LIBRARIES, AND WORKS 
LIKE THE L PARAMETER CN THE LOADER CALL. 
IT DOES NOT TERMINATE THE LOADING 
PROCESS. 

INCLUDE - THIS COMMAND ALLOWS THE USER TO CONTINUE 
DEFINING PARAMETERS IF THE SPACE 

AVAILABLE ON THE LOAD CONTROL STATEMENT 
IS NOT SUFFICIENT. THERE MAY BE ANY 

NUM8FR OF INCLUDES, EACH BEING PROCESSED 
AS ENTERED. 

CERTAIN SYMBOLS PERTINENT TO THE LOAOFRi 

LOWMEM SPECIFIES THE LOWER LIMIT FOR LOADING. 

DEFAULT VALUE = 00020 OCTAL 

HIGHHEM SPECIFIES THE UPPER LIMIT FOR LOADING. 

OEFAULT VALUE = 77776 OCTAL 

UCLM. LOWER LIMIT ON CHAPTER 2 COMMON. 

(UPPER MEMORY COMMON! OEFAULT VALUE IS 
20000 OCTAL. 

UCHM. UPPER LIMIT ON CHAPTER 2 COMMON. 

<UPPER MEMORY COMMON) DEFAULT VALUE IS 
53777 OCTAL. 
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PCD. BYTE SPECIFIES CERTAIN PARAMETERS ABOUT THE 

USE OF LOWMEM AND HIGHMEM. DEFAULT 

VALUE FOR PCO.BYTE IS GCQQ5 OCTAL. 
PC0.8YTE HAS THREE BITS USEO TO EFFECT 
THE LOADING OF PROGRAM, COMMON, ANO 
OATA SEGMENTS (HENCE THE *PCO* NAME). 
THE OTHER BIT IS USFD TO CONTROL 
OVERLAY GENERATION. THESE BITS AREl 

UXX XXX XXX XXX PCO (15 BITS OF PCO.BYTE) 

- IF i LOAO OATA ANO CHAPTER TWC COMMON FRO" 
HIGHMEM DOWN. IF LOAO OATA AND CHAPTER TWO 
COMMCN FROM LOWMEM UP. UQATA* INCLUDES LABELED 
COHMON). 

C - IF i LOAD COMMON FROM HIGHMEM DOWN. IF LOAO 
COMMCN FROM LOWMEM UP. 

P - IF 1 LOAO PROGRAH AREA FROM HIGHMEM DOWN, IF G 
LOAO PROGRAM AREA FRCM LOWMEM UP. 

U - IF i GENERATE OVERLAY (IF *0* PARAMETER IS 
S D ECIFIED) THAT WILL LOAO INTO UPPER MEMORY WHEN 
CALLED. (NOTE -THIS OOES NOT CAUSE THE LOAOER TO 

LOAO INTO UPPER MEMORY) 

X - NOT USEO BY LOAO 

EXAMPLES OF LOAOER CALLS! 

L0AD,56,L=MYLI3,0=0VERLAY 
RUN 

L3A0,I=L0A0C0MS*L=*APLI3,L=»KEITHL3,L=*SYSLIB 
EXS,0CTAL0UT=3IN0CT 

MAP=1C 
RUN 

LOAO 

EXS,PC0.3YTE = if0002 
INCLUDE, 56, O=10 
END 

LOAO 

EXS,PC0.3YTE=Q 

EXS*LOWM£M=<*Q0G1 

INCLUDE, 3^,35, 36, 37, 3 8, 0=99, L=*SYSL I 3 

MAP=2<* 

END 
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2.3S. LOGIN 



THIS COMMAND MAY BE GIVEN FROM TELETYPE-LIKE TERMINALS 
ONLY, AS ITS SINGLE PURPOSE IS TO PROVIDE * BLOTTED OUT 
AREA FOR THE USER TO TYPE IN HIS J03/USEP NUMBER. IT IS 
LEGAL ONLY IF THE USER IS NOT LOGGED IN. 



2.39. LOGOFF 



THE LOGOFF COMMAND TERMINATES A SESSION WITH OS-3. FROM 
THE TIME OF LOGIN, UNTIL LOGOFF, OS-3 KEEPS ACCOUNT OF 
THE RESOURCES USED. THESE CONSIST OF t 

1) CPU TIME IN MILLISECONDS 

2) WALL CLOCK (CONNECT) TIME IN SECONDS 

3) SAVE FILE SPACE IN FILE BLOCKS 
k) LINE PRINTER RECORDS PRINTED 

5) CARDS PUNCHED 

6) PLOTTER RECORDS PLOTTED 

8) MAGNETIC TAPE UNITS USED IN MILLISECONDS 

91 PAPER TAPE RECORDS PUNCHED 

10) CARDS READ IF FROM BATCH 

11) REMOTE LINE PRINTER LINES PRINTED 

12) HIGH SPEED DATA LINK RECORDS PROCESSED 

(THIS IS A SUBSCRIBED SERVICE AND MOST USERS 
WILL NOT EXPERIENCE CHARGES FOR IT) 

WHEN THIS COMMAND IS ENTEREO, OS-3 WILL PRINT A LIST OF 
CHARGES INCURRED SINCE LOGIN. ALL LOGICAL UNITS WILL 
THEN BE UNEQUIPPED. 



2.M). LUNLIST 

THIS COMMAND WILL PRINT A LIST OF LOGICAL UNITS 
CURRENTLY EQUIPPED BY THE USER AND THE STATUS OF EACH 
(SEE STATUS). THE FILE SIZE AND RECORD COUNT tFOR UNIT 
RECORD OEVICES) WILL BE PRINTED FOR BATCH AND TV USERS, 
BUT NOT FOR TTY USERS. FOR TTY USERS TO OBTAIN THIS 
INFORMATION, USE THE COHMANO LUNLIST, ALL. THIS WILL 
PRINT THE LUNS AND STATUS STATED ABOVE, BUT WITH EXTRA 
BLANKS SQUASHED INTO ONE OR TWO BLANKS. THE *ALL* 
PARAMETER IS IGNORED FROM TV OR BATCH. 

FOR UNIT RECORD DEVICES (LP, PLOT, TASK, PTP, PUN) THE 
DESTINATION (SEE SEND) WILL BE PRINTEO FOR ALL NON-SITE 
DESTINATIONS. 
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EXAMPLE! 






LUNLIST 






i 


FILE 


♦ ! 




13 


NULL 






2k 


TASK(NITEI 


]F 


31 


LP 


(WTR ) 


3 


k? 


LP 


IF 




60 


TV 






61 


TV 






100 


TV 






101 


TV 







23 9LKS 



k 


6LKS 


127 


RECS 


1 


3LKS 


17 


RECS 


2 


BLKS 


3** 


RECS 



HF9LKS 30 CFBLKS 30 MF3LKLIM 100 



2.U1. MERGE 



THIS COMMAND WILL CALL THE OS-3 MERGE UTILITY. TWO 
PARAMETERS ARE ALLOWED. THEY ARE tit TO SPECIFY MERGE 
OFTION INPUT UNIT, AND tOt TO SPECIFY A LOG UNIT FOR 
ERROR MESSAGES AND ERROR COUNTS. MERGE OPTIONS ARE AS 
FOLLOWS! 

8 - BLOCKING FACTOR 

- DUPLICATE KEY HANDLING 
E - END OF MERGE OPTIONS 

1 - INPUT FILE 
K - KEY FIELD 

L - LENGTH ERROR OPTIONS 

O - OUTPUT FILE 

P - PARITY ERROR OPTIONS 

R - RECORD SIZE 

S - SEQUENCE CHECKING OPTION 

T - TABLE FOR NON-STANDARO COLLATING SEQUENCF 

FOR DETAILED EXPLANATIONS OF MERGE OPTIONS AND FURTHER 
INFORMATION ON USING MERGE, SEE THE COMPUTER CENTER 
PUBLICATION CCM-70-17. 



2.<*2. MESSAGE 

MESSAGE IS A COMMAND WHICH WILL ALLOW A USER TO SEND A 
MESSAGE TO THE SYSTEM SITE OPERATOR, OR ANOTHER USER ON 
THE SYSTEM. r H £ CALLING SEQUENCES ARE! 

MESSAGE, OPR,<MESSAGE UP TO 69 CHARACTERS LONG> 

THE MESSAGE WILL BE WRITTEN ONTO THE OPERATORS 
CONSOLE, DISPLAYED ONTO THE OPERATORS CRT 
OISPLAY, AND THEN THE USER WILL 3E SUSPENDEO 
UNTIL THE SITE OPERATOR ANSWERS THE MESSAGE. IF 
THE USER IS SENDING THE MESSAGE FRCM A REMOTE 
TERMINAL, A TIME LIMIT OF TWO to THRFE MINUTES 
IS PLACED ON THE REQUEST SO THAT IF THE OPERATOR 
DOES NOT ANSWER THE MESSAGE WITHIN THIS PERIOD 
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OF TIM? THE MESSAGE WILL BE CANCELLED ANO THE 
SUSPENSION WILL 3£ RELEASED, SHOULD THIS 
HAPPEN, THE USER IS NOTIFIED WITH THE MESSAGE! 

TIME OUT -- TRY AGAIN LATER 

ANO THE OPERATOR IS INFORMED WITH ANOTHER 
MESSAGE THAT THE ORIGINAL HAS BEEN CANCELLED. 

MESSAGE, <TERMINAL>,<SAME LIMIT ON LENGTH> 

THIS MESSAGE WILL 3E WRITTEN ONTO THE TERMINAL 
OUTPUT OEVICE OF THE TERMINAL REQUESTED, UNLESS 
THAT USER HAS TURNEO ON HIS <INHI8IT MESSAGE> 
CONDITION WHICH WILL CAUSE AN ERROR MESSAGE TO 
8E SENT TO THE *SENOING* USER. 

MESSAGE, OFF 

THIS WILL INHI3IT MESSAGES FROM EVERYONE EXCEPT 
THE SITE OPERATOR, WHO WILL ALWAYS BE ABLE TO 
SEND A MESSAGE TO ANYCNE. 

MESSAGE, ON 

THIS CLEARS THE INHIBIT MESSAGE CONDITION SO 
SUBSEQUENT MESSAGES ARE RECEIVABLE. 

POSSIBLE ERROR MESSAGES ARE! 

TIME OUT — TRY AGAIN LATER. 

AS STATED A90VE UNDER MESSAGE, OPR, .. . 

MESSAGE REJECTED 

THE USER OR OPERATOR HAS INHIBITED 
MESSAGES FROM BEING SENT TO HIS TERMINAL. 

ILLEGAL TERMINAL 

THE TERMINAL NUMBER SPECIFIED IS NOT 
CURRENTLY LOGGED IN. 

MESSAGE, <TERM> ILLEGAL FROM DO FILE OR BATCH 

CONTROL MODE ENCOUNTERED A MESSAGE 
COMMAND DIRECTED TO A TERMINAL WHILE 
READING FROM A tQOt FILE OR A BATCH INPUT 
STREAM. THIS MESSAGE WILL BE PRINTED 
ONTO THE USER*S STANDARD OUTPUT UNIT CLUN 
iCll AND THE USER WILL BE PLACED INTO 
ABORT MODE. 

PLEASE NOTE THAT SENDING A MESSAGE TO TERMINAL GOG IS 
THE SAME AS SENOING ONE TO THE SITE OPERATOR (OPR) AND 
WILL SUSPEND THE USER UNTIL IT HAS BEEN ANSWERED OR 
TIMED OUT. 
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2.^3. MFBLKS 

HF6LKSf =<NUM9ER> OR *<NUM9ER>] 

IF THE DELIMITING CHARACTER CN *MFSLKS* IS A PLUS SIGN, 
THE LIMIT ON TEMPORARY SCRATCH SPACE WILL 3£ SET TO THE 
CURRENT SCRATCH SPACE IN USE PLUS THE NUMBER GIVEN IN 
THE PARAMETER. 

IF THE DELIMITER IS ANYTHING ELSE, THE LIMIT WILL BE SET 
TO EXACTLY THE NUMBER GIVEN, OF THE US£R*S ACCOUNT 
LIMIT, WHICHEVER IS LESS, 

IF THE DELIMITING CHARACTER IS A RETURN, THEN THE 
MAXIMUM SCRATCH USEO, CURRENT IN USE, AND THE ACCOUNT 
MAXIMUM IS PRINTED ONTO THE US£R*S TERMINAL, 

EXAMPLES? 

MFBLKS «-20 

MFBLKS=15G 

MFBLKS 

MF3LKS 3<* CF8LKS 12 MF9LKLIM «50 

IN THE ABOVE LINE, MFBLKS IS THE MAXIMUM USED, CF3LKS IS 
THE CURRENT IN USE, AND MFBLKLIM IS THE ACCOUNT MAXIMUM. 

2.^. MI 

MI MEANS /MANUAL INTERRUPT*. THIS COMMAND CAN 8E USED 
TO RETURN TO THE COMMAND MODE OF SOME PROGRAM WHICH HAS 
BEEN INTERRUPTED. FOR THE EXACT FUNCTION OF *MI* ON A 
PARTICULAR PROGRAM, CONSULT A MANUAL FOR THE PROGRAM 
BEING USEO. 

WHAT AN *MI* REALLY DOES* 

TYPING *MI* CAUSES A PSEUOO-HARDWARE INTERRUPT. AT 
LOCATION 12 (OCTAL) IN LOWER MEMORY, THE 16 9IT PROGRAM 
COUNTER OF THE USER*S PROGRAM IS STORED, AND THE SIGN 
BIT OF LOCATION 12 IS SET IF THE PROGRAM WAS IN *RIS* 
MCOE. THEN EXECUTION IS RESTARTED AT LOCATION 13. NONE 
OF THE USER*S REGISTERS ARE CHANGED. 

IF A PARAMETER LIST IS PRESENT, IT WILL BE PLACED INTO 
THE USER*S PARAMETER STRING. 

EXAMPLES* 

MI 
MI,K=1C02,C=7,S=65311 
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ERROR MESSAGES* 

CANNOT MI TO PROGRAM 

PROGRAM IS NOT SET UP TO ACCEPT AN MI. IF ONE 
WERF EXECUTED, THE PROGRAM WOULD LOSE CON T ROL. 
THE ONLY ACTION AVAILABLE IS TO TYPE *GO* TO 
CONTINUE EXECUTION. 
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OSCAR 

OSCAR IS THE ^OREGON STATE CONVERSATIONAL AID TO 
RESEARCH*. THIS COMMAND CALLS OSCAR FOR EXECUTION OF A 
PROGRAM, OR TO BE USED AS AN ON-LINE CACULATOR. THERE 
ARE TWO PARAMETERS AVAILABLE J 



I - 



R - 



SPECIFIES 

EXECUTES. 



INPUT OF A SOURCE PROGRAM TO 3E 



SPECIFIES A UNIT ONTO WHICH A LOG IS 
WRITTEN OF ALL COMMANDS TYPED TO OSCAR. 
THIS IS VALID ONLY FRO* TV. 



EXAMPLES! 



2.^6 



OSCAR 

OSCAR, I=OSCPROG 

OSCAR, R=REC0R03 

FCR MORE INFORMATION REFER TO COMPUTER CENTER MANUAL CCM 
69-2<*R 

OVLOAO 

QVLOAO,<LUN/NAME>£,<PARAMETER STRING* ] 

THIS COMMAND WILL 00 AN OVERLAY LOAD OF THE SPECIFIEO 
UNIT OR NAME. THE UNIT IS REWOUND IF POSSIBLE BEFORE 
USE. AFTER LOADING, CONTROL IS PASSED TO THE PROGRAM. 
THE PARAMETER STRING IS OPTIONAL, AS NEEDED BY THE 
PROGRAM. THIS COMMAND IS USEFUL WHEN A FILE NAME WHICH 
HAS THE SAME NAME AS A VALID CONTROL STATEMENT IS TO 3£ 
CALLED. E.G. *0VL0A0, EOI T* WOULD CALL THE OVERLAY 

*EOIT*, WHILE JUST TYPING *EDIT* WOULD CALL THE OS-3 
STANDARD TEXT EDITOR. 

EXAMPLES! 

0VL0AD,37 

VLO AD, ZIMZAM, 1 = 10,0=20, L=30 



kl 



OVLOAO,88,THIS IS THE PARAMETER STRING 



ERROR MESSAGES! 

OVLOAD FORMAT ERROR 

THE FILE NAME OR LUN SPECIFIED WAS NOT AN 
OVERLAY. 

LUN XX UNDEFINED 

THE LUN SPECIFIED 8Y XX WAS NOT EQUIPPED. 

<NAME> NOT FOUND 

THE FILE NAME <NAM£> COULD NOT BE EQUIPPED. 

<NAME> IS BUSY 

THE FILE NAME <NAM£> WAS NOT PROTECTED AND WAS 
EQUIPPED BY ANOTHER 

<NAME> INSUFFICIENT HARDWARE 

AN UNAVAILABLE PIECE OF HARDWARE WAS 
SPECIFIED. 

<NAM£> PARAMETER ERROR 

A MISSING OR ILLEGAL PARAMETER WAS SPECIFIED. 



2.1»7. RADAR 

THIS CONTROL MODE COMMAND WILL CALL RADAR, THE 
^REAL-TIME ASSEMBLER, DISASSEMBLER ANO AID TC RESEARCH*. 
FCR MORE INFORMATION SEE THE RADAR MANUAL1 CCM-70-9. 

EXAMPLE* 

RAOAR 

RADAR, <COMMAND LIST> 

2.*f9. RELEASE 

RELEASE IS A CONTROL FUNCTION USED TO OESTROY THE 
INFORMATION CURRENTLY ON THE SPECIFIED LUN. RELEASE I* 
VALID ON THE FOLLOWING DEVICES: 

ON LP, PLOT, PUN, TASK, PTP, ANO UNPROTECTED FILES 
AND RAFS, ALL INFORMATION IS DESTROYED. 

FOR f*T, THE TAPE IS REWOUND. 

FOR NULL, THE FUNCTION IS A NO-OPERAT I CN. 

EXAMPLE USE* 
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R£LEAS£,1C,2Q,30 

POSSIBLE ERROR MESSAGES I 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPO£D. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIED COULD NOT 3E RELEASED, 

2.<*9. RENAME 

RENAME* <OLONAM£>=<NEWNAME>£+ OR - 1 • . . • 

THIS COMMAND WILL CHANGE THE NAME OF A FILE FROM <OLDNAME> TO 
<N£WNAM£>. IF THE CHARACTER TERMINATING <N£WNAMF> IS A 
t*t THE <N£WNAME> FILE WILL 8E FILE PROTECTED. IF THE 
CHARACTER IS A t-t THE FILE WILL 8£ UNPROTECTED. 
OTHERWISE, THE FILE WILL HA\/£ THE SAME PROTECTION AS THE 
<OLDNAME> FILE. 

EXAMPLES! 

RENAME, ABCO^WXYZ 
RENAME, ZOT=*ZIM+ 
RENAME f 7IP=ZAP-,ZIM=ZAM+,FR0G=SM0G 

ERROR MESSAGES! 

<NAM£> IS BUSY 

THE FILE NAME <NAME> IS CURRENTLY EQUIPPED BY 
SOME OTHER USER. 

<NAME> DOES NOT BELONG TO YOU 

THE FILE NAME <NAME> DOES NOT BELONG TO YOUR 
ACCOUNT AND IS PROTECTED. 

<NAME> INSUFFICIENT HARDWARE 

YOU TRIED TO RENAME A PIECE OF HARDWARE WHICH 
CANNOT 8£ EQUIPPED AT THIS TIME, 

<NAM£> PARAMETER ERROR 

A MISSING OR ILLEGAL PARAMETER WAS SPECIFIEO. 



2.50. RESET 

THE RESET COMMAND UNEQUIPS LOGICAL UNITS WITHIN THE 
RANGE SPECIFIED 3Y THE PARAMETERS. IF THE DELIMITING 
CHARACTER IS A *♦*, RESET WILL ALSO UNEQUIP THE 
FILE-PROTECTED LUNS. OTHERWISE ONLY THE KON PROTECTED 
OR SAV^O LUNS ARE RESET. LP, PLOT, PTP, *>UN, TASK ARE 
NCN PROTECTABLE, AND ARE THEREFORE UNEQUIPPED BY BOTH 
RESET MODES* PARAMETERS AVAILABLE ARE USED TO SPECIFY 
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THE UPPER AND LOWER LIHTTS OF LUN(S) TO BE PRESET*. 
SYNTAX! 

RESETC+JCLOW LUNH ,HIGH LUN] 

IF THE HIGH LIMIT IS PRESENT, THE LOW LIMIT MUST ALSO BE 
PRESENT, ALL LUNS INCLUSIVE OF THE LOW AND HIGH LUNS 
WILL IE UNEQUIPPED ON THE BASIS OF THE *«■* PARAMETER AS 
OESCRISEO ABOVE. IF LUN 60 ANO 61 ARE INCLUDED WITHIN 
THE RANGE TO 8£ UNEQUIPPED, THEY WILL BE RE-EQUIPPED TO 
STANDARD INPUT ANO STANOARD OUTPUT, RESPECTIVELY, 

EXAMPLES: 

RESET ALL NON-PROTECTEO LUNS. 

RESET, 90 ALL NON-PROTECTED LUNS FROM 

90 TO 99. 
RESET* ALL LUNS. 

RESET*, 10, 3<* ALL LUNS FROM 10 TC 3<*. 
RESET, 9, 13 ALL NON-PROTECTEC LUNS F&OM 9 

TO 13. 

NCTEt THE t+t PARAMETER MUST 8E THE FIRST NON-BLANK 
CHARACTER FOLLOWING THE RESET COMMAND. 



2.51. REWINO 



THIS COMMAND WILL PLACE ALL LUNS SPECIFIED AT LOAO 
POINT. THE UNIT MUST 3E A FILE, RAF CR MT . 

EXAMPLES* 

REWIND, 10 
REWINO, 6, 5, ^, 3, 2 



POSSIBLE ERROR MESSAGES? 

LUN XX UNDEFINED 

THE LUN SPECIFIEO WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIED COULO NOT BE REWOUND. ONLY 
FILES, NULLS AND MAGNETIC TAPES CAN BE 
REWOUND. 
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2.52. RFP 



THIS CONMANO WILL REMOVE FILE PROTECTION FROM THE 
SPECIFIED LUNS OR FILE NAMES. IF A LUN IS SPECIFIED AND 
ALREADY SAVED, THE USER MUST RFP THE FILE NAME. A USER 
CANNOT RFP A PU3LIC OR SEMI-PRIVATE FILE THAT 3EL0NGS TO 
ANOTHER USER OR A FILE CURRENTLY IN USE 3Y ANOTHER USER 
C8USY). 



EXAMPLES* 



RFP, 10,20 

RFP, MYLI8, 1,56 

RFP,ZIP,ZAP,ZIM,ZAM,10 



ERROR MESSAGES? 

LUN XX UNDEFINED 

THE LUN SPECIFIED BY XX WAS NOT EQUIPPED. 

<NAME> IS 3USY 

THE FILE NAME <NAM£> WAS ALSO EQUIPPED 8Y SOME 
OTHER USER, 

LUN XX IS SAVED 

THE LUN XX IS SAVED. YOU MUST SPECIFY THE 
FILE NAME IN ORDER TO REMOVE PROTECTION FROM A 
SAVED FILE. 

<NAM£> OOES NOT 8EL0NG TO YOU 

THE FILE NAME <NAM£> 3ELONGS TO ANOTHER USER*S 
ACCOUNT. 



2.53. SAVE 



THE SAVE COMMAND IS USED WHENEVER THE USER WISHES TO 
STORE FILE OR RAF INFORMATION ON A PERMANENT BASIS. THE 
LUN MUST BE A FILE OR RAF. THE NAME SPECIFIED CAN BE 
ANY LENGTH, HOWEVER, ONLY THE FIRST EIGHT CHARACTERS 
WILL BE USED. THE NAME MUST NOT CURRFNTLY EXIST, OR AN 
ERROR WILL RESULT. THE NAME CANNOT BE ONE OF THE 
AVAILA3LE HARDWARE TYPES (SEE EQUIP). IF THE LUN IS 
FILE PROTECTED, THE NAME WILL BE PROTECTED AS WELL. 

EXAMPLES! 

SAVE,iG=Z0Tl,ii=Z0T2,l2=Z0T3 
SAVE,8=*8LIP0UT 



ERROR MESSAGES? 
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LUN XX UNOEFINEO 

THE LUN SPECIFIED BY XX WAS NOT EQUIP°E0. 

<NAM£> ALREADY EXISTS 

THE FILE NAHE <NAME> IS ALREADY SAVED. YOU 
MUST CHOOSE ANOTHER NAHE. OR DELETE OR 
DESTROY THE FILE, AND THEN TRY THE SAVE AGAIN. 

LUN XX NOT A FILE OR RAF 

THE LUN SPECIFIED 3Y XX IS NOT SA\/A3LE. ONLY 
FILES AND RAFS CAN BE SAVED. 

LUN XX NOT ENOUGH SAVEO FILE SPACE 

YOUR ACCOUNT OOES NOT HAVE ENOUGH SAVED FILE 
SPACE IN ORDER TO SAVE THE LUN SPECIFIED 8Y 
XX, YOU MUST OELETE OR DESTROY SOME EXISTING 
FILES IN ORDER TO MAKE ROOM FOR THE NEW FILE. 

<NAME> IS AN ILLEGAL NAME 

YOU GAVE AN ILLEGAL NAME FOR A SAVED FILE. 
YOU CANNOT SAVE A FILE WITH THE SAME NAME AS 
AN EQUIPA8LE HARDWARE DEVICE <LP, PUN, ETC.). 
CHOOSE ANOTHER NAME AND TRY AGAIN. 

LUN XX ALREAOY SAVED 

THE LUN SPECIFIEO BY XX ALREAOY HAS A 
PERMANENT NAME ASSOCIATED WITH IT. A LUN 
CANNOT BE SAVEO UNDER MORE THAN ONE NA"E AT A 
TIME. 

SAVEO FILES ARE CONSIDERED PRIVATE (EGUIPA3LE ONLY ON 
THE SAME J08/USER NUMBER SAVED UNDER) UNLESS THE FIRST 
CHARACTER OF THE FILE NAME IS ONE OF THRE£ SPECIAL 
CHARACTERS AS FOLLOWS! 

* - INDICATES THE FILE IS PUBLIC. ANY OS-3 USER 
MAY EQUIP THE FILE. 

$ - INDICATES THE FILE IS PUBLIC, BUT IS 
*RUN-ONLY*. IT IS ACCESSA3LE BY ANY OS-3 USER, 
BUT CAN BE RUN ONLY, IT CAN NOT BE EXAMINED OR 
COPIED BY ANY USER. 

* - INDICATES THE FILE IS SEMI-PUBLIC. THIS IS 
SIMILAR TO A PUBLIC FILE, BUT THE FILE CAN BE 
tQUIPPED ONLY 3E USERS HAVING THE SAME ACCOUNT 
NUMBER AS THE FILERS OWNER. THEY NEED NOT HAVE 
THE SAME VALIDITY CODE. 
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2.5*f. SDR 



THIS COMMAND WILL REWIND THE SPECIFIED LUN TO LOAD POINT 
ANO SET IT INTO ^DESTRUCTIVE READ* MODE. THIS IS A MODE 
THAT CAUSES THE FILE TO 3£ *EATEN* AS IT IS READ. AS 
EACH RECORD IS READ FRCM THE FILE, IT IS FREED TO THE 
FREE FILE POOL TO ALLOW THE SPACE TO BE USED AGAIN BY 
OTHER USERS, THE ADVANTAGE TO THIS IS THAT IT WILL 
LOWER THE *MF8LKS* OR SCRATCH SPACE IN USE BY THE USER 
AS THE FILE IS READ. 

FCR EXAMPLES A USER HAS A FILE THAT IS 57 BLOCKS LONG 
THAT HE WISHES TO COPY TO THE LINE PRINTER. IN ORDER TO 
MAKE A COPY OF THIS FILE* THE USER MUST OUPLICATE ITS 
CONTENTS ONTO AN *LP* FILE TYPE. TO DO THIS WOULD 
NORMALLY REQUIRE TWICE THE FILE SPACE SINCE THE FILE 
WOULD HAVE TO EXIST AS 80TH THE SCRATCH FILE ANO THE 
LINE PRINTER FILE BEING COPIED. IF THE USER*S TOTAL 
*MFBLK* OR SCRATCH FILE BLOCK LIMIT IS ONLY IOC SLOCKS 
HE CANNOT COPY IT. HOWEVER, IF THE USER PLACES THE FILE 
IN *SOR* MODE, ONLY ONE COPY OF THE FILE NEED TO EXIST 
AT A TIME, SINCE THE INPUT COPY IS DESTROYED AS IT IS 
READ, IN PRACTICE* AN EXTRA BLOCK IS NEEDED. 

WARNING vvvvvvvvvw THERE IS NO (REPEAT I NO! TURNING 
SACK. ONCE A FILE HAS BEEN SORTED IT CAN CNLY BE READ, 
RELEASED, CLEARED, ANO UNEQUIPPED. THUS YOU SHOULD 
EXERCISE EXTREME CAUTION IN USING THIS FILE COMMAND. 

THE CONTROL STATEMENT *COPY* ALLOWS THE t/Ot 
SPECIFICATION ON THE INPUT UNIT tq ALLOW THE USER TO 
SPECIFY A DESTRUCTIVE REWIND BEFORE THE COPY IS BEGUN. 
FOR INFORMATION, SEE COPY. 

POSSIBLE ERROR MESSAGES? 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIEO COULO NOT BE PLACED INTO 
DESTRUCTIVE READ MODE. ONLY FILES, MAGNETIC 
TAPES, AND NULLS CAN BE S0R2D. FOR MAGNETIC 
TAPES, THE FUNCTION MERELY CAUSES A REWIND. 



2.55. SEFB 



THIS COMMAND WILL CAUSE THE SPECIFIED FILE TO BE 
SEARCHED EACKWARO UNTIL THE SPECIFIED NUMBER OF FILE 
MARKS. THE LUNS MAY BE SPECIFIEO ONE AT A TIHt, OR THE 
USER MAY LSE THE REPEAT FACTOR (SEE 3KSP). SEFB IS 
LEGAL ON FILES ANO TAPES ONLY, 

EXAMPLES* 
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S£F3,1G,2G 

SEF3,7(12) ,9,1A,97(3) 



POSSIBLE ERROR MESSAGESi 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIED COULD NOT 3E SEF8*ED. ONLY 
FILES, MT*3 AND NULLS CAN BE SEFB*EO. 



2. 56. SEFF 



THIS COHMANO FUNCTIONS EXACTLY AS THE SEFB COMMAND, 
HOWEVER, THE SEARCH IS MADE IN THE FORWARD DIRECTION. 
(SEE SEFB) SEFF IS LEGAL ON FILES, RAFS, ANC TAPES ONLY. 

FCR A RAF, THE SEFF COMMAND WILL CAUSE THE RAF TO BE 
PLACED AT THE PHYSICAL END OF INFORMATION. 

EXAMPLES! 

SEFF, 10, 23 
S£FF,l(10i),2<5),6 



POSSIBLE ERROR MESSAGES! 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

THE LUN SPECIFIED COULO NOT BE SEFF*EO. ONLY 
FILES, MT*S, RAFS, AND NULLS CAN 3E SEFF*£D. 



2.57. SEND 



THIS COMMANO IS USED TO CONTROL ROUTING OF INFORMATION 
TO SPECIFIC DEVICE OR BATCH QUEUES. BATCH INFORMATION 
(CARD IMAGE DECKS) ON TASK FILES CAN 3E SENT TO A 
VARIETY OF QUEUES WHICH WILL PROCESS THE J03S ACCORDING 
TC THE RESOURCES THEY REQUIRE. THESE QUEUES ARE* 

NITE - JOBS WILL NOT BEGIN EXECUTION UNTIL THIRD 
SHIFT (CHEAPEST) IS IN EFFECT. (DOES NOT 
RUN ON WEEKENDS) 

LOW - JOBS WILL NOT BEGIN UNTIL SECOND OR THIRD 
SHIFT IS IN EFFECT. 

FAST - JOSS REQUIRING LESS THAN 3? CPU SECONDS 
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ANO iOG SCRATCH FILE 3LOCKS. 
MT1 - JOBS REQUIRING i TAPE DRIVE. 
MT2 - JOBS REQUIRING 2 TAPE DRIVES. 
MT3 - J08S REQUIRING 3 TA^E DRIVES. 
HTk - JOSS REQUIRING i* TA°E DRIVES, 
TASK - OEFAULT TASK QUEUE, 

THE FORMAT OF THE SEND COMMAND ISl 

SENO <LUN> TO <OESTINATION> 

WHERE <OESTINATION> IS ANY OF THE ABOVE NAHES ^OR OTHER 
DEVICES, THE DESTINATIONS ARE* 

LINE PRINTER 

SITE - ANY SITE LINE PRINTER 
PRi - SITE PRINTER NUMBER i 

CARD PUNCH 

SITE - ANY SITE PUNCH 
XY PLOTTER 

SITE - ANY SITE PLOTTER 
PAPER TAPE PUNCH 

SITE - ANY SITE PAPER TAPE PUNCH 

POSSIBLE ERROR HESSAGESt 

LUN XX UNDEFINED 

LUN IS NOT EQUIPPED 

LUN XX NOT UNIT RECORD DEVICE. 

LUN MUST 3E A LP ♦ PLOT, PTP, PUN OR TASK TO 
BE *SENQA8LE*. 

<NAME> DESTINATION UNKNOWN 

DESTINATION SPECIFIED IN SENO IS UNKNOWN TO 
OS-3. 



THE TERM *SITE# IS USEO TO DESCRIBE ANY DEVICE AT 
THE OSU MILNE COMPUTER CENTER. 
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2.58. SFBLKS 



THIS COMMAND CAUSES THE CURRENT SAVE FILE BLOCKS AND THE 
SAVED FILE BLOCK LIMIT TO BE PRINTEO ONTO THE USER*S 
OUTPUT DEVICE, THE DIFFERENCE BETWEEN THE VALUES OF 
SFBLKS AND SFBLKLIM REPRESENTS THE STORAGE AVAILABLE FOR 
MCRE FILES. EACH FILE SAVED WILL BE CHARGED FOR THE 
SPACE USED BY THE FILE PLUS ONE BLOCK FOR THE NAME. 



2.59. SORT 



THIS COMMAND CALLS THE OS-3 SORT UTILITY. SORT IS A 
GENERAL-PURPOSE SORT-MERGE WHICH ALLOWS INPUT FROM UP TO 
THIRTY-TWO INPUT FILES. SORT ALLOWS TWO PARAMETERS ON 
THE CALL. THE tit PARAMETER IS USED TO SPECIFY LOGICAL 
UNIT FOR INPUT OF SORT OPTIONS. THE tot PARAMETER IS 
USED TO SPECIFY A LOG UNIT FOR ERROR MESSAGES AND RECORD 
COUNTS. SORT ALLOWS SEVERAL OPTIONS AS FOLLOWS! 

3 - BLOCKING FACTOR 

E - END OF SORT OPTIONS 

I - INPUT FILE 

K - KEY FIELD 

L - LENGTH ERROR OPTIONS 

- OUTPUT FILE 

P - PARITY ERROR OPTIONS 

R — RECORD SIZE 

T - TABLE FOR NON-STANDARD COLLATING SEQUENCES 

FCR DETAILED EXPLANATIONS OF AVAILABLE OPTICNS AS WELL 
AS FURTHER INFORMATION ON USING SORT, PLEASE REFER TO 
THE COMPUTER CENTER PUBLICATION CCM-71-06. 



2.60. START 



THE START COMMAND WILL START EXECUTION AT THE ADDRESS 
SPECIFIEO. THE ADDRESS MUST BE A SIX OR FEWER DIGIT 
OCTAL NUMBER. IF NO PARAMETER IS PRESENT, IS ASSUMED. 
EXAMPLES! 

START 

START,770 0G,I = iO,0 = 2 0,S=3G,T = **G,X = 8 
START, 177531 

ANY PARAMETER LIST PRESENT WILL BE PLACED INTO THE 
USER*S PARAMETER STRING BEFORE STARTING. 
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2.61. STATUS 



IF A PARAMETER IS INCLUDED, THEN A LINE IS PRINTED FOR 
EACH ITEM SPECIFIED IN THE PARAMETER STRING, THIS LINE 
WILL CONTAIN STATUS ABOUT EACH FILE OR LUN GIVEN, THIS 
INFORMATION WILL CONTAIN SPECIAL CHARACTERS WHICH HAVE 
THE FOLLOWING MEANINGS! 

CHARACTER DEFINITION 



♦ READ-ONLY FILE (PROTECTED) 

C LOAO POINT 

] END OF DATA 

F FILE HARK PROCESSEO 

D FILE IN DESTRUCTIVE READ MODE 

8 BINARY RECORD PROCESSEO 

A ABNOR HAL/UN AVAILABLE 

E AOORESS ERROR <RAF ONLY) 

S FILE IS SAVEO 

THE ABOVE INFORMATION MAY B£ FQLLQWEQ BY ADDITIONAL 
FILE-SI ZE/RECORO-COUNT INFORMATION IF THE INFORMATION IS 
APPLICABLE TO THE TYPE, 

THE NUMBER OF PARAMETERS SPECIFIED IS LIMITED ONLY BY 
THE LENGTH OF THE RECORD INPUT, EXAMPLES! 

STATUS, ZIP 

ZIP FILE ♦CIS 

STATUS,1C 

LUN 10 UNDEFINEO 

STATUS, *HI 

♦HI FILE +CS 1 BLKS 

STATUS, 14 

LUN 14 LP (WTR ) IF 4 BLKS 254 RECS 

STATUS,i,2,3,FRESH,*LIB,HELP 
LUN 1 FILE IF 4 BLKS 
LUN 2 PUN 1 1 8LKS 245 RECS 
LUN 3 PTP )F 1 BLKS 121 RECS 
FRESH FILE t IS 
♦LIB RAF +£S 99 BLKS 
HELP NAME NOT FOUND 



THE STATUS COMMAND (WITHOUT PARAMETERS) WILL PRINT A 
LIST OF THE USER*S HARDWARE REGISTERS AND THEIR CONTENTS 
ONTO HIS TERMINAL. THIS IS USEFUL WHEN A PROGRAM HAS 
BOMBED COMPLETELY AND HE WISHES TO ANALYZE IT OR TAKE 
THE OUTPUT TO A CONSULTANT FOR HELP. EXAMPLE! 

STATUS 
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p 120221 

LJA 131002 

A QQ0C0C32 

Q 12130556 

Bl 55<f21 

8? 00315 

33 77775 

£U 27730000 

EL 776<f2160 

<ROS> 

<A0V><DIV><EXP><9C0> 

IM=<A0V/0IV><£XP/3C0> 



HEANING OF THE ABOVE INFORMATION! 



P IS THE SIXTEEN 3IT PROGRAM COUNTER. POINTS TO 
CURRENT INSTRUCTION TO 9E EXECUTED, 

LJA IS THE LAST- JUMP-ADDRESS REGISTER. CONTAINS 
THE PROGRAM ADDRESS OF LAST 9RANCHING INSTRUCTION. 

A IS THE 2h BIT ACCUMULATOR. 

Q IS THE 2k BIT QUOTIENT REGISTER. 

31 IS INDEX REGISTER 1. 

32 IS INDEX REGISTER 2. 

33 IS INDEX REGISTER 3. 

EU IS UPPER Zk BITS OF £ REGISTER. 

EL IS LOWER 2k 3ITS OF £ REGISTER. (THE E REGISTER 
IS FOR FLOATING POINT ANO OOUBLE PRECISION 
OPERATIONS) 

<ROS> - USER IS IN ROS MODE. 

<AOV> - AN ARITHMETIC OVERFLOW HAS OCCURRED. 

<QIV> - A DIVIDE FAULT HAS OCCURRED (DIVIDE BY 0) 

<EXP> - AN EXPONENT FAULT HAS OCCURRED (E.G. 
OVERFLOW OR UNDERFLOW) 

<3CO> - A 3CO CONVERSION FAULT (SOP CONDITION ONLY) 
HAS OCCURRED. 

IM= INDICATES CONTENTS OF INTERRUPT MASKt 

<AOV/OIV> - ARITHMETIC OVERFLOW AND DlVI'JE FAULT 
INTERRUPTS ARE ENA9LE0. 
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<EXP/3C0> - EXPONENT FAULT ANCJ BCD FAULT INTERRUPTS 

ARE ENA8LE0. 



2.62, SUBMIT 



SUBMIT IS A COMMAND TO AIO IN SUBMITTING TASK JOSS FROM 
INTERACTIVE TERMINALS, RUNNING BATCH JOSS, OR TASK JOBS. 
THE GENERAL FORMAT IS* 

SUBMIT t ,I=<LUN>/<NAME>3t ,C=<CHAR> 1 , <OU£UE >£ , <COMMENT>] 

THE I PARAMETER SPECIFIES THE INPUT UNIT TO SUBMIT 
FROM. IF NO I PARAMETER IS SPECIFIED THE USER MUST 8E A 
BATCH OR TASK JOB AND INPUT DEFAULTS TO LUN 100. 

THE C PARAMETER IS USEO TO SPECIFY THE CHARACTER TO BE 
CHANGED TO A t (7/8) IF FOUND IN COLUMN ONE OF AN INPUT 
RECORO. 

SUBMIT WILL READ THE FIRST RECORO FROM THE INPUT UNIT* 
IF THIS RECORD IS A JOB CARD, IT WILL USF THE QUEUE 
PARAMETER FROM THIS CARD IF ONE WAS NOT SPECIFIED ON THE 
CSU8MIT CALL, IF A JOB NUMBER AND VALIDITY CODE ARE 
PRESENT ON THIS JOB CARD, THEY WILL 8E USED FOR THE J08 
TC 3£ SUBMITTED. IF NO JOB NUMBER OR VALIOITY CODE ARE 
PRESENT, THE SUBMITTING USERS ACCOUNT WILL 3E USED. A 
TASK WILL BE CREATED BY WRITING THIS FIPST JOB CARD ONTO 
THE UNIT, SENDING IT TO THE SPECIFIED QUEUE (SITE IS THE 
DEFAULT! AND COPYING ALL RECORDS AFTER THIS FROM THE 
INPUT UNIT ONTO THE TASK. COPYING WILL CEASE WHEN AN 
MATCHING NUMBER OF CENDSUB CARDS FOR EACH [SUBMIT CARD 
NOT CONTAINING AN tit PARAMETER HAVE BEEN COPYIEO. 
COPYING WILL CEASE IMMEDIATELY IF A CLOGOFF CARD IS READ 
REGARDLESS OF HOW MANY OUTSTANDING (SUBMIT CARDS REMAIN. 

ERROR MESSAGES: 

INPUT NOT ALLOWEO FROM XXXX 

XXXX IS THE HARDWARE TYPE OF THE INPUT UNIT. 

DESTINATION UNKNOWN 

THE DESTINATION SPECIFIED IS UNKNOWN TO OS-3. 
SUBMIT WILL SCAN FOR A MATCHING ENDSU3 CARD - 
NO J03(S) WILL BE SUBMITTED. 

A30R T MODE — SUBMIT NOT PROCESSED. 

THE USER WAS IN ABORT MODE WHEN SUBMIT WAS 
ENTERED. SUBMIT WILL SCAN FOR THE MATCHING 
CEN0SU8 CARD IF THIS IS THE CASE AND NO J08<S> 
WILL 3E SUBMITTED. 

INPUT RECORD LONGER THAN <*Q WORDS. 

THIS IS AN ABNORMAL CONDITION. PLEASE BRING 
OUTPUT TO A SYSTEMS PROGRAMMER FOR ANALYSIS. 
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INPUT UNIT IS ABNORMAL/UNAVAILABLE. 

THE INPUT UNIT (LUN 100) BECAME ABNORMAL WHILE 
READING, PLEASE BRING OUTPUT t A SYSTEMS 

PROGRAMMER. 

IN ANY CASE, IF SUBMIT FINOS AN ERROR ANO ISSUES 
ONE OF THE ABOVE DIAGNOSTICS, NO TASK WILL BE 
SUBMITTED. THE TASK IS RELEASED AND RECORDS ARE 
READ FROM THE I UNIT IIF POSSIBLE! UNTIL A MATCHING 
NUMBER OF [ENOSUB CAROS HAVE BEEN REAO. THE JOB IS 
THEN ABORTED ANO PLACED INTO CONTROL MODE. 



2.63. SYSTAT 



SVSTAT IS A PROGRAM WHICH ALLOWS THE USER TO PEEK INTO 
THE INNARDS OF OS-3 ANO OBTAIN INFORMATION ABOUT RUNNING 
JOBS, QUEUES ANO OTHER USERS ON THE SYSTEM, SYSTAT MAY 
8E CALLED IN TWO WAYS* 

1) SYSTAT, <CONMANO TO BE £XECUTED> 
2* SYSTAT 

IN EXAMPLE 1, SYSTAT WILL DO THE COMMANO ANO THEN EXIT 
BACK TO CONTROL MODE. IN EXAMPLE 2, SYSTAT WILL ENTER 
AN INTERACTIVE MODE WHERE THE USER MAY REQUEST A DISPLAY 
ANO U*>ON COMPLETION OF THAT DISPLAY REQUEST A NEW 
OISPLAV OR ISSUE ANOTHER COMMANO. 



2.63.1. SYSTAT COMMANDS 



2.63.1.1. ABORT 

THIS COMMAND ALLOWS A USER TO ABORT A RUNNING BATCH JOB. 

ISSUING THIS COMMAND WILL CAUSE THE BATCH JOB SPECIFIED 

TC ENTER ABORT MODE. ANY *XA80RT* OR *UNA3HRT* CONTROL 

CARD IN THE INPUT STREAM WILL REMOVE THE ABORT 
INOICATOR. THE COMMAND FORMAT IS: 

ABORT, <RELATIVE BATCH TERMINAL NUM3ER> 

WHERE <RELATIVE BATCH TERMINAL NUMB£R> IS AS DISPLAYED 
BY THE *BATCH* OR ^STATUS* COMMANDS. 



ERROR MESSAGES? 

JOB NOT FOUND 

THE JOB SPECIFIED DOES NOT EXIST. 

JOB DOES NOT BELONG TO YOU 

THE JOB EXISTS, BUT THE JOB NUMBER ANO 
VALI3ITV COOE 00 NOT MATCH YOURS. 
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PARAMETER ERROR 

A MISSING OR ILLEGAL PARAMETER WAS SPECIFIED. 



2. 63. 1.2. BATCH 

THIS COMMAND WILL PRINT OUT TWO LINES 0^ STATUS FOR EACH 
JC3 LISTED. THE COMMAND FORMAT IS J 

3ATCHt,<J03 NUM3ER>] 

IF THE PARAMETER IS MISSING, ONLY JOBS WITH THE SAME JOS 
NUMBER AS THE CALLER WILL BE LISTED. IF THE PARAMETER 
IS OR *ALL* THEN ALL JOSS WILL BE LISTED. THE OUTPUT 
FORMAT ISI 

J03NUM Q I/O CPU MF3LKS TAPE 

0M75<t335(TASK> RUN 0110/1005 Ou56GV020C3 c/C 
RF6G=G 00 0000 RF61= 120112 3k RF??= OCC 30 60 2 

THE NUMBER LEFT OF THE tit IS THE RELATIVE BATCH 
TERMINAL NUMBER USED IN DROPPING OR ABORTING THE JOB 
(SEE THE SECTION ON ABORT OR DROP*. THE ITEM UNDER tQt 
IS THE QUEUE FROM WHICH THE JOB LOGGED IN. THE ITEM 
UNDER *I/D* IS THE IOBOUND CODE (SEE THE SECTION ON 
IC80UN0 CODES). THE CPU TIME OF THE JOB IS GIVEN AS CPU 
TIME USED/CPU TIME LIMIT. THE MF3LKS ARE MFBLKS 

USE0/MF8LK LIMIT. TAPE INFORMATION IS E/R WHERE £ IS 
TAPES EQUIPPED AND R IS TAPE ORIVES RESERVED 3Y THE J03. 
THE SECOND LINE CONTAINS THE CONTENTS OF THE USERS 
REGISTER FILES 603, 618 ANO 773 (773 CONTAINS CERTAIN 
JOB STATUS BITS SUCH AS ABORT, RESTRICT, DROP, LOADING 
DELETED, ETC. FOR MORE INFORMATION, SEE THE SECTION ON 
REGISTER FILE 778 BIT DEFINITIONS. 

THIS COMMAND MAY BE ABBREVIATED TC JUST *8*. 



2.63.1.3. DROP 

THIS COMMAND ALLOWS THE USER FROM A REMOTE TERMINAL TO 
*DROP* OR PERMANENTLY ABORT A JOB CURRENTLY EXECUTING OR 
ONE STILL IN THE INPUT QUEUE. THE COMMAND FORMAT ISI 

DROP,<RELATIVE BATCH TERMINAL NU«3FR> 

-OR- 

OROP,<QUEU£ NAME>,<RELATIVE POSITION WITHIN QUEU£> 

IF THE JOB IS EXECUTING, IT WILL 3E ABORTED WITH A 
MESSAGE STATING SO, AND BE PLACEO INTO A MODE WHICH WILL 
READ ALL INPUT FROM LUN 100 UNTIL END OF DATA IS REACHED 
(ALL CONTROL CAROS GONE). MULTIPLE JOB/LOGOFF GROUPS 

SUBMITTED FROM TASK WILL ALL GO AWAY, MULTIPLE JOBS 
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SU8MITTE0 FROM A CARD READER WILL SHOW UP AS SEPARATE 
ENTRIES IN THE INPUT QUEUE AND MUST 9E DROPPED 
INDIVIDUALLY. 

JOSS DROPPED WHILE IN AN INPUT QUEUE WILL BE HARKED SO 
THE SYSTEM WILL KNOW NOT TO ALLOW EXECUTION UPON LOGGING 
ON, WHEN THE J08 DOES LOG ON, A MESSAGE WILL 3E PRINTED 
AND IT WILL THEN ENTER THE MODE SPECIFIED ABOVE TO CAUSE 
ALL INPUT TO BE CONSUMED. ONCE A JOB HAS BEEN DROPPED, 
ONLY AN OPERATOR CAN REMOVE THE *DROP* CONDITION, AND 
NOT EVEN HE OR SHE CAN SAVE A RUNNING JOB THAT HAS BEEN 
DROPPED, SO BE CAREFUL. 



2.63.1.<». EXIT 

THIS COMHANO TERMINATES SYSTAT EXECUTION AND RETURNS THE 

USER TO CONTROL *OOE . 



2.63.1.5. HELP 

THIS COMMAND PRINTS 
ASPECT OF SYSTAT. 
WANTEO>. IF SYSTAT IS 



HELPFUL INFORMATION ABOUT SOME 

COMHANO FORMAT IS* HELP,<ITEM 

UNABLE TO FIND INFORMATION ON THE 



ITEM OESIRED, A MESSAGE IS PRINTED STATING THE ERROR. 



2.63.1.6. INPUT 

THIS COMMAND WILL PRINT INFORMATION ABOUT THE INPUT 
QUEUES. THE COMMAND FORMAT IS I 

INPUTt, QUEUE NAME] 



IF QUEUE NAME IS MISSING OR *ALL< 
BE PRINTED. THE OUTPUT FORMAT ISt 



THEN ALL QUEUES WILL 



QUEUE 
00 NITE 
LOW 
MT1 
MT2 
MT3 
MT<* 
TASK 
RJEA 
RJEB 
CR1 
FAST 



01 
02 
03 

05 
06 
07 
10 
11 
12 



RUN 

00 

00 

OC 

00 

00 

00 

03 

00 

00 

00 

00 



WAIT 

000 

000 

000 
000 
CGC 
GOO 
000 
LOG 
QOL 
OQC 
000 



LIM 

02 

01 

01 

02 

01 

01 

03 

01 

01 

01 

01 



THE ENTRY UNDER *RUN< IS THE NUMBER OP JOBS CURRENTLY 
EXECUTING FROM THIS QUEUE. THE ENTRY UNDER *WAIT* IS 
THE NUMBER OF JOBS WAITING BEHIND THE RUNNIhG JOBS. THE 
ENTRY UNDER *LIM* IS THE MAXIMUM NUMBER 0^ SIMULTANEOUS 
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JOBS ALLOWED to EXECUTE FROM THIS QUEUE. 

FOR INFORMATION ABOUT THE QUEUES, SEE THE SECTION ON 
IN^UT ANO OUTPUT QUEUES, 

THIS COMMAND MAY 8E ABBREVIATED TO JUST tit. 



2,63.1.?. J03LIST 

THIS COMMAND WILL GIVE A LIST OF TERMINAL NUMBERS ANO 
J03 NUMBERS MATCHING THE JOB NUMBER REQUESTED. THE 
FORMAT OF THE COMMAND IS I 

J03LISTC 

,TTYt=t£<PHY TERN NUM>J A/3/C/0J 13 . , . 
f ,TV3,. . 
C ,3AT].«. 
COET1... 
( ,<J08 NUM3ER»1 

A JOB NUMBER OF OR *ALL* WILL MATCH ANY J08 NUMBER ON 
THE SYSTEM, 

THE ITEMS IN £ 3 ARE OPTIONAL, WITHOUT PARAMETERS, THE 
OEFAULT IS <YQUR JOB NUM3ER>, SOME EXAMPLES ARE! 

J03LIST LIST ALL TERMINALS WITH HATCHING 

JOB NUMBERS. 

J03LIST,TV LIST TV*S WITH SAME J03 NUMBER AS 

YOURS, 

J03LIST,TTY=:A LIST ALL TERMINALS ON MULTIPLEXOR 

A, 

J03LIST,TTY=i*52A LIST TERMINAL ANO JOB NUMBER OF 

USER ON **52A, 

J03LIST,7*ii02% LIST ANY TERMINAL WITH J03 NUMBER 

OF 7^iG2<*. 

J03LIST,ALL LIST ALL TERMINALS 

THE FORMAT LISTED 3Y THIS COMMAND ISt 

TERM JOBNUM 

OOQ-DET 67301*3 
10^-3«f2A*741012 
1Q6-123B+7MQ12 

THE t*t MEANS THAT THE J08 NUMBER AND VALIDITY CODE OF 
THE CALLER MATCH THOSE OF THE LISTED USER, THE *«■* 
INDICATES THE CALLER*S ENTRY IN THE LIST, 
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THIS COMMAND MAY 8E ABBREVIATED TO JUST *J*. 



2.63.1.3. LINFUT 

THIS COMMAND WILL PRINT THE INFORMATION FOUND UNDER THE 
I OR INPUT COMMAND, BUT WILL ALSO PRINT INDIVIDUAL 
ENTRIES IN THE INPUT QUEUES AND CERTAIN STATUS ABOUT 
EACH. THE COMMAND FORMAT ISl 

LINPUTC, QUEUE NAMEt,<JOB NU*BFR> 1 1 

IF THE QUEUE NAME IS MISSING OR *ALL* THEN ALL QUEUES 
WILL BE PRINTED. IF THE <J03 NUM3ER> IS MISSING, ONLY 
ITEMS BELONGING TO THE CALLER WILL BE PRINTED. IF THE 
<J03 NUMBER> IS *ALL*t THEN ALL ITEMS IN J hE QUEUE WILL 
BE PRINTED. 

THE OUTPUT FORMAT IS* 



QUEUE 


RUN 


WAIT 


LIM 


00 NITE 


00 


0G0 


02 


01 LOW 


00 


000 


01 


02 MTi 


00 


000 


CI 


03 MT2 


00 


000 


02 


G** MT3 


00 


OCO 


01 


05 MT*» 


00 


000 


01 


06 TASK 


03 


005 


03 


0021755^20 T 






0031755^20 I 


3 




07 RJEA 


30 


0G£ 


01 


11 CR1 


00 


000 


01 


12 FAST 


00 


QCG 


01 



THE ENTRY UNDER *RUN* IS THE NUMBER OF JOBS CURRENTLY 
EXECUTING FROM THIS QUEUE. THE ENTRY UNDER *WAIT* IS 
THE NUMBER OF JOBS WAITING BEHIND THE RUNNING JOBS. THE 
ENTRY UNOER *LIM* IS THE MAXIMUM NUMBER OF SIMULTANEOUS 
JOBS ALLOWEO TO EXECUTE FROM THIS QUEUE. 

ITEMS SUBMITTED FROM *TASK* OR *SU8MIT2ED JOBS ARE 
MARKED WITH A tit (TASK ORIGIN). ITEM MARKED WITH A tBt 
WERE REAO FROM A CARD READER. ITEMS MARKED WITH A *D* 
HAVE BEEN *DROPPEO* BY EITHER THE OPERATOR OR A USER 
(SEE THE SECTION ON DROP). 

THIS COMMAND MAY BE ABBREVIATED TO JUST *LI*. 



2,63.1.9. LOUTPUT 

THIS COMMAND WILL LIST INFORMATION FOUND UN1ER THE OR 
OUTPUT COMMAND, BUT WIlL ALSO LIST EACH ENTRY FOUND IN 
AN OUTPUT QUEUE AND CERTAIN STATUS A30UT THAT ENTRY. 
THE COMMAND FORMAT IS* 
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LOUTPUTt, QUEUE NAMEC,<J08 NUM3EP>1] 

IF THE QUEUE NANE IS MISSING OR *ALL* THEN ALL QUEUES 
HILL BE PRINTED. IF THE <J08 NUMBER> IS MISSING, ONLY 
ITEMS BELONGING TO THE CALLER WILL BE PRIMEO. IF THE 
<JOB NUM3ER> IS *ALL*, THEN ALL ITEMS IN THE QUEUE WILL 
SE PRINTED* BLOCKS OF ELEMENTS NOT BELONGING TO THE JOB 
NUMBER REQUESTED HAVE THEIR COMBINED TOTAL PRINTED IN A 
MESSAGE OF THE FORMI 

GROUP OF NNNNNN 8L0CKS (NNNNNN IS TOTAL) 

THE OUTPUT FORMAT IS* 

10 LEFT FILES TOTAL 
PRi 00022 010 00130 
0001750123 A 00022 
GROUP OF Q0Q1O0 BLOCKS 
009*750123 00009 
0101750123 AF 00071 
PLTi 00000 000 00000 
PUN 0000 000 osooo 
PTP 00000 000 00000 
LINK 000 CO 000 0000 
RJEA 00000 000 00000 
RJE3 00000 000 00000 

THE ENTRIES UNOER *LEFT* ARE TOTAL FILE BLOCKS LEFT IN 
CURRENT OUTPUT FILES. THE ENTRIES UNQEP *FILES* ARE 
TOTAL NUMBER C^ OUTPUT FILES REMAINING IN THE QUEUE. 
THE ENTRIES UNOER *TOTAL* ARE THE TOTAL FILE BLOCKS 
REMAINING IN THE QUEUE (DOES NOT INCLUDE THE CURRENT 
OUTPUT FILEI. 

AN *A* IN THE QUEUE ENTRY SAYS THE USER WAT IN *A80RT 
MODE* WHEN THE FILE WAS UNEQUIPPED. THIS IS NORMAL FOR 
FILES CREATED FROM A TERMINAL, AS ANY ^ILLEGAL CONTROL 
STATEMENT* WILL CAUSE THE ABORT MODE CONDITION TO 8E 
SET. FROM BATCH, IT OOES MEAN THE JOB ABORTED <OR WAS 
ABORTED I BEFORE IT TERilNATEO. 

AN tFt IN AN OUTPUT QUEUE ENTRY MEANS THE FILE WILL 
REQUIRE SPECIAL FORMS OR HANDLING BY THE OPERATOR. 

THIS COMMANO MAY BE ABBREVIATED TO JUST *LO*. 



2.63.1.10. OUTPUT 

THIS COMMANO WILL LIST STATUS OF THE OUTPUT QUEUES. THE 
COMMAND FORMAT ISt 

OUTPUTt, QUEUE NAME! 

IF QUEUE NAME IS MISSING OR *ALL* THEN ALL QUEUES WILL 
BE PRINTED. THE OUTPUT FORMAT IS? 
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10 

PR1 

*>LT1 

PUN 

PTP 

LINK 

RJEA 

RJE8 



LEFT FILES 



0CC22 
0QG00 
0C033 
OOfiOO 
00000 
O0GO0 
G0G00 



0C2 

OQG 

oca 

00 G 
00G 
AGO 
OGG 



TOTAL 
G0G30 
OGGOQ 
OGGOO 
00000 
00000 
00000 
00000 



THE ENTRIES UNOER *LEFT* ARE TOTAL FILE BLOCKS LEFT IN 



CURRENT OUTPUT FILES. THE 
TOTAL NUM6ER OF OUTPUT FILES 
THE ENTRIES UNOER *TOTAL* 
REMAINING IN THE QUEUE (DOES 
OUTPUT FILE), 



ENTRIES UNOER *FILES* ARE 
REMAINING IN THt QUEUE. 
ARE THE TOTAL FILE 3L0CKS 
NOT INCLUDE THE CURRENT 



FCR INFORMATION 
QUEUES. 



A90UT THE QUEUES, SEE THE SECTION ON 



THIS COMMAND MAY 3£ ABBREVIATED TO JUST tot 



2.63.1.11. STATUS 

THIS COMMAND WILL LIST ONLY THE FIRST LINE OF 
INFORMATION PRINTED BY THE B OR BATCH COMMAND. THE 
COMMAND FORMAT ISt 

STATUS!, <J03 NUMBER>) 

IF THE JOB NUMBER IS MISSING, ONLY JOBS WITH THE SAME 

JOB NUMBER AS THE CALLER WILL BE PRINTEO. IF THE JOS 

NUMBER IS OR *ALL* THEN ALL JOBS WILL BE PRINTED. THE 
OUTPUT FORMAT ISl 



J03NUM Q I/O CPU 

09175*335(TASK> RUN 0110/liiGO 



MF3LKS 
00560/02CG0 



TAPE 
0/0 



THE NUMBER LFFT OF THE *«* IS THE RE 
TERMINAL NUMBER USED IN OROPPING OR ABO 
(SEE ABORT OR DROP). THE ITEM UNDER fQt I 
FROM WHICH THE J08 LOGGED IN. THE ITEM U 
THE IOBOUND COOE (SEE THE SECTION ON 108 
THE CPU TIME OF THE JOB IS GIVEN AS CPU 
TIME LIMIT. THE MF3LKS ARE MFBLKS USED/ 
TAPE INFORMATION IS E/R WHERE E IS TAPES E 
IS TAPE DRIVES RESERVED BY THE JOB. 



LATIVE BATCH 
RTING THE JOB 
S THE QUEUE 
NOER *I/0* IS 
CUNO COOES). 
TIME USED/CPU 
MFBLK LIMIT. 
QUIPPED AND R 



THIS COMMANO MAY BE ABBREVIATEO TO JUST *S*. 



2,63.1.12. USERS 



THIS COMMAND WILL 
1-0 STATUS, CPU TIME 



tPOC 



LIST THE TERMINAL NUMBt-'b , 

USED, WALL CLOCK TIME USED 



JOB NUMBER, 
(CONNECT 



TIMEIf MF8LKS (SCRATCH FILE SPACE IN USE), AND NUMBER OF 
MAGNETIC TAPES IN USE AND RESERVED BY AMY USER ON OS-3. 
THE PARAMETER FORMAT IS THE SAME AS FOR THE tJt COMMAND! 

USERSC 
,TTYt=t€<PHY TERM NUM>} A/3/C/D3 31 » . * 

£ ,TV3.. . 
C ,9AT1. .. 
[ ,D£T3... 
£,<J03 NUM3ER>3 

A JOS NUMBER OF OR *ALL* WILL MATCH ANY JOB NUMBER ON 
THE SYSTEM. 

THE ITEMS IN f 1 ARE OPTIONAL. WITHOUT PARAMETERS* THE 
DEFAULT IS <YOUR JOB NUM9ER>. 

THE OUTPUT FORMAT IS* 

TERM JOBNUM I/O CPU WC BLKS MT 

GQCHDET 6730«f3 RUN I 9523 

10^-1238 70 53«i I IN 6 1112 1 

117-TV 755023 TV 1** 0H2 123 1/1 

THE CPU TIME IS IN SECONDS. THE WALL CLOCK TIME IS IN 
HOURS AND MINUTES. MT INFORMATION IS E/R WHERE E IS 
NUMBER OF TAPES EQUIPPEO AND R IS THE NUMBER OF TAPE 
DRIVES RESERVED. 

FCR DEFINITIONS OF THE I/C CODES SEE THE SECTION ON 
ICBOUND CODES. 

THIS COMMAND MAY BE ABBREVIATED TO JUST *U*. 



2.63.2. OISPLAY INFORMATION DEFINITIONS 
2.63.2.1. INPUT AND OUTPUT QUEUES 

INPUT QUEUES CURRENTLY AVAILABLE UNDER OS-3 VERSION 6.1$ 
NAME PURPOSE 

NITE JOBS WISHING TO EXECUTE ONLY DURING THIRD 

SHIFT. 
LOW JOBS WISHING TO EXECUTE ONLY OURING SECOND OR 

THIRD SHIFT. 
MT1 JOBS REQUIRING 1 TAPE DRIVE. 
MT2 JOBS REQUIRING 2 TAPE DRIVES AT CNCE. 
MT3 JOBS REQUIRING 3 TAPE DRIVES AT ONCE. 
MTtf JOBS REQUIRING k TAPE DRIVES AT ONCE. 
TASK JOBS SUBMITTED FROM TERMINALS OR THROUGH 

*SU3MIT*. 
CR1 JOBS READ FROM SITE CARO READER. 
RJEA JOBS ^ROM RJE STATIONS. 
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FAST J08S REQUIRING LESS THAN 30 CPU SECONDS ANO 
LESS THAN 1QC MF8LKS (SCRATCH OISK SPACE). 
FAST JOSS HAVE A HIGHER PRIORITY THAN ANY 
OTHER INPUT QUEUE FOR LOGGING IN, HOWEVER, 

AFTER IT IS LOGGEO IN, IT IS GIVEN THE SAME 
PRIORITY AS ALL OTHER JOBS, 



OUTPUT QUEUES AVAILABLE* 

NAH£ PURPOSE 

PR1 SITE PRINTER NUMBER 1. 

PLTi SITE PLOTTER NUM8ER 1. 

PUN SITE CARD PUNCH. 

PTP SITE PAPER TAPE PUNCH, 

LINK UNUSEO AT PRESENT, WILL BECOME 

INTER-COMPUTER LINK DEVICE. 

RJEA RJE OUTPUT LINE PRINTER STATION 1. 

RJEB RJE OUTPUT LINE PRINTER STATION 2. 



2.63.2.2. REGISTER FILE 773 BIT DEFINITIONS 

REGISTER FILE 77B CONTAINS USEFUL INFORMATION CONCERNING 
THE J03*S STATUS. THE BITS ARE! 

OCTAL BIT MEANING 



1*0000000 ABORT FLAG, 

2JQ0G0Q0 RESTRICTED MODE 

10000000 MESSAGE INHIBIT (BETWEEN USERS) 

0<ffl0OQ0fl DROP FLAG. 

000X0000 DELAY 0-7 (X) CHAR TIMES AT EOL 

O000XXQO BATCH QUEUE OF ORIGIN * 2 

00000020 PUBLIC MESSAGE AVAILABLE 

00000010 CALL OVERLAY IN RF758, RF76B. 

0000000** ROS*D UPON EXECUTION OF *JUMP* 

00000002 DATE HAS BEEN CALLED 

OQOOOOfll LOADING DELETED FLAG, 



2.63.2.3, I08CUND COOES 

THE I030UNQ FIELD DESCRIBES ANY EVENTS OP CONDITIONS FOR 
WHICH THE JOB IS WAITING, THE FOLLOWING ARE THE 

POSSIBLE COOES* 

NAME MEANING 

RUN J08 IS EXECUTING. 

IN JOB WAITING FOR TTY OR RJE CONSOLE INPUT. 

OUT JOB WAITING FOR TTY OR RJE CONSOLE OUTPUT TO 

FINISH. 
DISK JOB WAITING FOR DISK IN&UT/OUT0UT. 
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MSG JOB WAITING FOR OPERATOR MESSAGE REPLY, 

CTY J03 WAITING FOR HESSAGE TO APPEAR ON 

OPERATORS CONSOLE TYPEWRITER {TAPE EQUIP OR 

DISK PACK MOUNT!, 
TV JOB WAITING FOR TV INPUT OR OUTPUT, 
HOG JOB NEEDS MORE MEMORY THAN CURRENTLY 

AVAILABLE. IT WILL BE RESTARTED WHEN 

SUFFICIENT MEMORY IS AVAILABLE AND WILL BE 

GIVEN HIGH PRIORITY FOR 3 SECONDS, 
CR JOB WAITING FOR CARD READER INPUT OR DATA 

FRO* SOME HIGH SPEEO INPUT DEVICE. 
STOP OPERATOR HAS STOPPED THE JOB, 
MNT JOB IS WAITING FOR THE OPERATOR TO MOUNT SOME 

REMOVABLE DEVICE (TAPE, DISK PACK), 
MEMO JOB IS WAITING IN MEMORY ALLOCATION FOR SOME 

DIRECT 1-0 TRANSFER (TV OR TAPE), 
TIME JOB IS WAITING FOR ELAPSEO TIME TO EXPIRE ON 

A TIME DELAY XRE'Q. 
PHAN JOB IS WAITING FOR PHANTOM TO PROCESS SOME 

FUNCTION, 
XREQ JOB IS WAITING FOR NON-RESIDENT XREQ 

PROCESSING. 

A *-* SIGN TO THE LEFT OF THE I030UNO CODE INDICATES THE 
JC3 IS CURRENTLY EXECUTING A SHARED MONITOR FUNCTION 
(USER I-O, SCHEDULER, ETC.) 
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2.63,3. SYSTAT COMMANDS FOR THE RJE CONSOLE USER 



2.63.3.1. AUTO 

SETS AUTOHATIC SPOOLING. AS EACH NEW FILE ENTERS THE 
OUTPUT QUEUE FOR THIS SITE, OR AS EACH FlLf FINISHES 
OUTPUTTING, THE NEXT AVAILABLE FILE FOR THIS SITE WILL 
BEGIN OUTPUTTING. THIS IS THE DEFAULT STATE WHEN A USER 
LCGS ON TO AN RJE DEVICE. 



2.63.3.2. BEGIN 

BEGIN OUTPUTTING FILE SPECIFIED Br THE <OUTPUT FILE 
NUM8ER>. THIS NUMBER IS THE RELATIVE POSITION WITHIN 
THE OUTPUT QUEUE AS DISPLAYED BY SYSTAT. 

IF THE OUTPUT QUEUE WAS EMPTY WHEN THE COMMAND IS 
ISSUED, THE MESSAGE OUTPUT IDLE IS DISPLAYED. 

IF OUTPUT IS IN PROGRESS WHEN THIS COMMAND IS ISSUED, 
THE MESSAGE OUTPUT ACTIVE IS DISPLAYED. 



2 .63. 3 .3. GO 

RESTARTS PRINTER AFTER A FORMS WAIT CONDITION OR AN 
EQUIPMENT CHECK CONDITION (PAPER OUT, ETC.). ALSO 
INITIATES READING CAROS IF THE READER HAS BEEN REAOIEO. 



2.63.3.<». HOLD 

SETS MANLAL OUTPUT SPOOLING. THIS COMMAND CAUSES 
AUTOMATIC QUEUEING TO CEASE. AFTERWARDS, EACH OUTPUT 
FILE MUST BE INDIVIDUALLY STARTED WITH THE BEGIN 
COMMAND, OR THE USER MUST ENTER AN AUTO COMMAND TO 
REVERSE THE HOLD. 

IF THIS COMMAND IS ENTERED WHILE A FILE IS BEING 
PRINTED, THE FILE WILL PRINT TO COMPLETION, BUT NO NEW 
FILES WILL BEGIN UNTIL AN AUTO OR BEGIN COMMAND IS 
GIVEN. 



2.63,3,5. KILL 



THIS COMMAND KILLS THE CURRENT OUTPUT FILE. 
ON THE FILE IS RELEASED TO THE SYSTEM AND THE 
IN SEQUENCE IS STARTED IF THE TERMINAL IS IN 
ONCE THIS COMMAND HAS BEEN ENTERED, THE FIlE 



ALL SPACE 
NEXT FILE 
AUTO *CQE. 

IS GONE. 



IF NO OUTPUT 
OISPLAYEO. 



IS IN PROGRESS, THE MESSAGE OUTPUT IDLE IS 
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IF THE TERMINAL IS IN HOLD MODE AT THE TIME THIS COMMAND 
IS ENTEREO, OUTPUTTING WILL CEASE ANO THE USER MUST 
ENTER A BEGIN OR AN AUTO COMMAND TO BEGIN MORE OUTPUT. 



2.63.3,6. RERUN 

THIS COMMAND PLACES THE CURRENTLY OUTPUTTING FILE AT THE 
EKO OF THE OUTPUT QUEUE. THIS MAKES IT THE LAST 0^ THE 
LIST OF OUTPUT FILES TO 9E SENT TO THE TERMINAL. AS 
OTHER FILES ARE ENTEREO INTO THE RJE OUTPUT QUEUE, THEY 
WILL 3E PLACEO 8EHIND IT. IF NO OUTPUT IS IN PROGRESS, 
THE MESSAGE OUTPUT IDLE IS DISPLAYED. 

IF THE TERMINAL IS IN HOLD MODE AT THE TIME THIS COMMAND 
IS GIVEN, NO NEW OUTPUT WILL BE STARTED UNTIL THE USER 
ISSUES AN AUTO OR BEGIN COMMANO. 



2.63.3.7. REWIND 

THIS COMMAND WILL REPOSITION THE CURRENT OUTPUT FILE TO 
ITS BEGINNING ANO RESTART IT. THE OUTPUT WILL CONTINUE 
REGARDLESS OF THE AUTO/HOLO STATUS OF THE TERMINAL. IF 
THE TERMINAL IS NOT CURRENTLY OUTPUTTING, THE MESSAGE 
OUTPUT IOLE IS DISPLAYED. 



2.63.3.3. ROUTE 

THIS COMMANO WILL TAKE A FILE IN THE USERS OUTPUT QUEUE, 
AND RE-QUEUE IT FOR PRINTING AT SOME ALTERNATE SITE. IF 
THE <SIT£> IS OMITTED, THEN SITE (OSU COMPUTER CENTER) 
IS ASSUMED. 

IF THE FILE SPECIFIED CANNOT 3E FOUND, THE MESSAGE 
FILE NOT IN QUEUE IS DISPLAYED. TF THE FILE DOES NOT 
BELONG TO THIS SITE, THE MESSAGE FILE NOT FOR THIS SITE 
IS DISPLAYED. IN EITHER CASE* NOTHING MORE IS DONE. 



IN AOOITICN TO ANY ERROR MESSAGES LISTED ABOVE, THE 
FCLLOWING ARE ALSO POSSIBLE* 

ILLEGAL COMMAND 

COMMAND NOT RECOGNIZED. 

PARAMETER ERROR 

MISSING OR ILLEGAL PARAMETER. 

LEGAL ONLY FROM RJE CONSOLE 

RJE FUNCTIONS CAN ONLY BE EXECUTED 
FROM A PROPERLY SIGNED-ON RJE 
CONSOLE. 



65 



2.6<f. TAPEMAX 

THIS COMMAND WILL ALLOW A USER TO LOWER THE NUMBER OF 
TAPES CURRENTLY RESERVED FOR HIS USE, THE FORMAT IS* 

TAPEMAX=<NEW NUMBER TO RES~RVE> 

IF THE AMOUNT SPECIFIED IS GREATER THAN THE NUMBER 
CURRENTLY RESERVED AN ERROR IS PRINTED* 

ILLEGAL ATTEMPT TO INCREASE TAPEMAX 

IF THE AMOUNT SPECIFIED IS LESS THAN THE NUMBER OF TAPES 
STILL IN USE (EQUIPPED* ANOTHER ERROR IS ISSUED* 

MORE TAPES ARE ALREADY IN USE, 

IT IS A GOOD IDEA TO USE THE TAPEMAX COMMAND WHEN A JOS 
HAS FINISHED USE OF ITS TAPES BUT STILL HAS COMPUTING TO 
00, THIS FREES THE TAPE DRIVES TO BE USED BY SOME OTHER 
JOB. 

MORAL: BE KIND TO YOUR FELLOW USERS. 



2.65. TERMINAL 

THIS COMMANO WILL PRINT A MESSAGE OF THE FORM? 

MM/OO/YY HHIMMtSS TERMINAL LLL-PPPM TRAFFIC IS XX 

ONTO THE USER*S TERMINAL. THE HHIMMSSS IS MILITARY 

TIME. MM/DO/YY IS THE DATE . LLL IS THE LOGICAL 

TERMINAL NUMBER. PPP IS THE PHYSICAL TERMINAL NUMBER, 
AND X IS THE MUX (A, 3, C* OR D) INTO WHICH THE USER IS 
CONNECTEO. THE TRAFFIC IS THE SAME AS GIVEN BY THE 
COMMAND <TRAFFIC>. 

THIS COMMAND MAY BE GIVEN WITHOUT LOGGING IN. 

2.66. TIME 

THIS COMMANO HAS THE FOLLOWING THREE FORMS I 

1) TIHE=<NUMBER> 

THIS ESTABLISHES AN UPPER LIMIT OF <NU«3ER> 
SECONDS ALLOWED IN THE CURRENT SESSION < SINCE 
LOGIN) BEFORE THE SYSTEM INTERRUPTS THE JOB AND 
ISSUES A *TIM£-CUT* DIAGNOSTIC. 

2) TIME*<NUM3ER> 

THIS SECOND FORM TAKES THE NUMBER OF CPU SECONDS 
ALREADY USED BY THE JOB SO FAR, AND ADOS TO THIS 
THE <NUMBER> SPECIFIED AND USES THE T OTAL TO 
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ESTABLISH A NEW UPPER LIMIT. 

31 TIME 

THIS FORM CAUSES THE CONTROL MODE PROGRAM TO 
DISPLAY THE TOTAL NUMBER OF CPU SECONDS USED 
SINCE LOGIN. THE FORMAT OF THIS OUTPUT IS* 

CPU 12.2 SEC WC 20.3 MIN 

IN THE EVENT THAT A *TIME-CUT* MESSAGE IS ISSUED, THE 
USER MAY* IF DESIRED, ENTER A TIME COMMAND TO ESTABLISH 
A NEW LIMIT ON CPU TIME FOR THE SESSION, TO RESUME 
PROGRAM EXECUTION, ENTER A *GO* COMMAND. (SEE *GO*). 



2.67. TRAFFIC 

THIS COMMAND IS USED TO PRINT THE ^"OTAL NUMBER OF 

CURRENT LSERS LOGGED IN TO OS-3. THIS CCMMAND MAY BE 

ISSUED WITHOUT LOGGING IN, TO ESTIMATE THE LOAD. 
EXAMPLE? 

TRAFFIC 



2.63. UNABORT 

THIS COMMANO WILL CLEAR A J03*S ABORT FLAG. AFTER THIS 
COMMAND, NORMAL CONTROL MODE COMMANDS ARE AGAIN LEGAL. 

EXAMPLE* 
UNABORT 



2.69. UNEQUIP 

THIS COMMAND WILL DISASSOCIATE THE LOGICAL UNIT 
SPECIFIEO FROM THE HAROWARE TYPE OR FILE NAME CURRENTLY 
ECUIPPEO TO. IF THE FILE WAS NOT SAVED, ITS CONTENTS 
ARE LOST. IF THE FILE WAS A LP, PLOT, PTP, PUN, OR 
TASK, THE OUTPUT WILL BE QUEUED FOR PROCESSING BY OS-3 
AS AN OUTPUT FILE, OR AS A TASK JOB. EXAMPLES J 

UNEQUIP, 10, 12,3*f 
UNEQUIP, 99 
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POSSIBLE ERROR MESSAGES! 

LUN XX UNDEFINED 

THE LUN SPECIFIEO WAS N'OT EQUIPPED. 

LUN XX IS PROTECTED 

THE LUN SPECIFIED 3Y XX WAS PROTECTED. YOU 
CANNOT UNEQUIP PROTECTED FILES OR RAFS. 



2.7Q, WFM 



WFM IS USED TO WRITE A FILE HARK ONTO THE SPECIFIED LUN. 
A REPEAT DESIGNATOR CSEE 3KSP) IS PERMITTED TO ALLOW 
MULTIPLE FILE MARKS TO 3£ WRITTEN ONTO A SINGLE LUN. 
EXAMPLES! 

WFM, 10 

WFM, 3(1233) ,7,8,^3(5) 

-WFM IS ILLEGAL ON PROTEGTEO FILES OR RAFS. 



POSSIBLE ERROR MESSAGES* 

LUN XX UNDEFINED 

THE LUN SPECIFIED WAS NOT EQUIPPED. 

ILLEGAL FUNCTION LUN XX 

A FILE MARK COULD NOT 3E WRITTEN ONTO THE 
SPECIFIED FILE. 



2.71. XA30RT 

THIS COMMAND WILL REVERSE THE J03S ABORT FLAG, IF THE 
JOS WAS NOT ABORTED, IT WILL A30RT IT. IF THE J03 WAS 
IN ABORT MOOE, ITS A30RT FLAG WILL 3E CLEARED. 

THIS COMMAND ALLOWS THE USER SOME LIMITED ^CONDITIONAL* 
CONTROL STATEMENT EXECUTION. 
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